SMSKap DEVELOPERS
TRENARPTDE中文RUHIESFR
SMSKAP DEVELOPER API

Einfache, zuverlässige und transparente SMS-Verifizierungs-API.

Die SMSKap Developer API bietet genehmigten Konten physische Nicht-VoIP-SIM-Nummern für WhatsApp, WhatsApp Business und Telegram mit transparenten Standard-Katalogpreisen und automatischer Erstattung.

API-Basis-URLhttps://api.smskap.com/v1
01 · SCHNELLSTART

In drei Schritten integrieren

Beantragen Sie den API-Zugang, erstellen Sie Ihren Live-Schlüssel nach Freigabe und binden Sie die Schnittstelle sicher über Ihren Server an.

1Antrag stellen

Submit your developer form to begin the review process.

2Freigabe abwarten

Get notified once your account is reviewed and approved.

3Live-Schlüssel erstellen

Generate your live secret key and configure it on your server.

02 · AUTHENTIFIZIERUNG

Sichere Bearer-Token-Authentifizierung

Übertragen Sie Ihren API-Schlüssel bei jeder Anfrage im Authorization: Bearer <key> Header. Der geheime Schlüssel wird nur einmalig bei der Erstellung angezeigt.

curl https://api.smskap.com/v1/account \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
Hinterlegen Sie Ihren Live-Schlüssel niemals in browserseitigem Code oder öffentlichen Repositories.
03 · KONTO & GUTHABEN

Konto- und Guthabenstatus

Rufen Sie GET /v1/account auf, um Ihr Guthaben, die Währung (TRY) und zugewiesene Limits abzufragen.

GET/v1/accountGenehmigter Live-Schlüssel erforderlich
{
  "account": { "balance": 450.00, "currency": "TRY" },
  "application": {
    "name": "Production Bot",
    "status": "approved",
    "requests_per_minute": 60,
    "daily_activation_limit": 200,
    "currency": "TRY"
  },
  "environment": "live",
  "request_id": "req_01J8SMSKAP123456789"
}
04 · KATALOG & PREISE

Standard-Dienst- und Länderkatalog

Unsere Infrastruktur konzentriert sich gezielt auf 3 Kerndienste und 3 weltweite Länder mit höchster Zustellquote.

Supported Services

WhatsApp whatsapp
WhatsApp Business whatsapp-business
Telegram telegram

Supported Countries

Türkiye (+90) tr
United States (+1) us
United Kingdom (+44) gb
Transparente Standardkatalog-Preise

Keine versteckten Aufschläge oder unvorhersehbare Anbieterkosten. Alle API-Preise basieren auf unseren Standard-Katalogpreisen. Großkunden können im Admin-Panel individuelle Rabatte erhalten.

GET/v1/countriesAktive Länder (TR, US, GB)
GET/v1/servicesAktive Dienste (WhatsApp, WhatsApp Business, Telegram)
GET/v1/offersLive-Preise und Verfügbarkeit
05 · AKTIVIERUNGS-API

Nummernreservierung, SMS-Abfrage & Erstattung

Reservieren Sie eine Nummer, fragen Sie den eingehenden SMS-Code ab oder stornieren Sie fristgerecht. Bleibt der Code aus, wird das Guthaben umgehend erstattet.

POST/v1/activationsNummer reservieren (POST /v1/activations)
curl -X POST https://api.smskap.com/v1/activations \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: e9b8d2e1-4567-4d89-b123-987654321abc" \
  -H "Content-Type: application/json" \
  -d '{
    "service_key": "whatsapp",
    "country_code": "tr"
  }'
{
  "activation": {
    "id": "AKT-260827-ABC123",
    "status": "waiting_code",
    "service_key": "whatsapp",
    "service_name": "WhatsApp",
    "country_code": "tr",
    "country_name": "Türkiye",
    "number": "+905301234567",
    "code": null,
    "sale_amount": 40.50,
    "currency": "TRY",
    "expires_at": "2026-10-19T21:05:00Z",
    "cancellable_at": "2026-10-19T20:47:00Z",
    "poll_interval_seconds": 3
  },
  "request_id": "req_01J8SMSKAP123456789"
}
GET/v1/activations/{activation_id}SMS abfragen (GET /v1/activations/{id})
curl https://api.smskap.com/v1/activations/AKT-260827-ABC123 \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
{
  "activation": {
    "id": "AKT-260827-ABC123",
    "status": "code_received",
    "code": "482910",
    "sale_amount": 40.50,
    "currency": "TRY"
  },
  "request_id": "req_01J8SMSKAP123456789"
}
DELETE/v1/activations/{activation_id}Stornieren & Erstatten (DELETE /v1/activations/{id})
06 · OFFIZIELLES PYTHON SDK

Offizielles Python SDK

Integrate in seconds using our official open-source Python SDK with automated polling and refund handling:

pip install smskap
from smskap import SMSKapClient, SMSKapError

client = SMSKapClient(api_key="sk_live_xxxxxxxxxxxxxxxxxxxxxxxx")

try:
    # 1. Numara rezerve et (WhatsApp / Türkiye)
    act = client.create_activation(service="whatsapp", country="tr")
    print(f"Tahsis edilen numara: {act['number']} (ID: {act['id']})")

    # 2. SMS kodunu otomatik dinle (120 saniyeye kadar)
    code = client.wait_for_code(activation_id=act["id"], timeout=120)
    if code:
        print(f"SMS Doğrulama Kodu: {code}")
    else:
        # Kod gelmezse iptal et; bakiye anında iade edilir
        client.cancel_activation(act["id"])
        print("Süre doldu, rezervasyon iptal edildi ve bakiye iade edildi.")

except SMSKapError as e:
    print(f"Hata [{e.code}]: {e.message}")

GitHub Repository & Source Code ➔

07 · LIMITS & SICHERHEIT

Sicherheit, Nachverfolgung und Limits

Die API-Nutzung wird durch konfigurierbare Sicherheitslimits geschützt.

Minutenlimit (Rate Limit)

Maximal zulässige Anfragen pro Minute. Liefert bei Überschreitung HTTP 429 und Retry-After.

Tageskontingent für Aktivierungen

Maximale Anzahl an Aktivierungen pro Kalendertag; kann bei Bedarf skaliert werden.

Anfrage-ID (request_id)

Eindeutige ID bei jeder Antwort zur schnellen Zuordnung im Supportfall.

Idempotency-Key: Erforderlicher UUID-Header bei POST-Anfragen zur Verhinderung doppelter Abrechnungen bei Netzwerkwiederholungen.
08 · FEHLERCODES

Standardisierte Fehlercodes

Alle Fehler antworten im einheitlichen JSON-Format. Verarbeiten Sie error.code in Ihrer Anwendungslogik.

HTTPFehlercode (error.code)Bedeutung und Maßnahme
400invalid_payloadMissing or invalid payload (service_key or country_code outside supported catalog).
400insufficient_balanceAccount balance is insufficient. Top up balance in the user panel.
400cancel_window_expiredCancellation window expired or SMS code already delivered; cannot be cancelled.
401invalid_api_keyInvalid, missing or revoked Bearer API key.
403forbiddenDeveloper application pending approval or suspended.
404no_numbers_availableNo numbers available right now for this service and country. Please retry shortly.
404activation_not_foundThe requested activation ID does not exist.
409activation_conflictConflict detected on activation or duplicate idempotency key.
429rate_limit_exceededRate limit exceeded. Wait the number of seconds specified in the Retry-After header.
429daily_activation_limit_exceededDaily activation quota reached. Contact support to request a quota increase.
503service_temporarily_unavailableCarrier network is temporarily unavailable. Please retry shortly.