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.
https://api.smskap.com/v1In 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.
Submit your developer form to begin the review process.
Get notified once your account is reviewed and approved.
Generate your live secret key and configure it on your server.
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"Konto- und Guthabenstatus
Rufen Sie GET /v1/account auf, um Ihr Guthaben, die Währung (TRY) und zugewiesene Limits abzufragen.
/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"
}Standard-Dienst- und Länderkatalog
Unsere Infrastruktur konzentriert sich gezielt auf 3 Kerndienste und 3 weltweite Länder mit höchster Zustellquote.
Supported Services
whatsappwhatsapp-businesstelegramSupported Countries
trusgbKeine versteckten Aufschläge oder unvorhersehbare Anbieterkosten. Alle API-Preise basieren auf unseren Standard-Katalogpreisen. Großkunden können im Admin-Panel individuelle Rabatte erhalten.
/v1/countriesAktive Länder (TR, US, GB)/v1/servicesAktive Dienste (WhatsApp, WhatsApp Business, Telegram)/v1/offersLive-Preise und VerfügbarkeitNummernreservierung, 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.
/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"
}/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"
}/v1/activations/{activation_id}Stornieren & Erstatten (DELETE /v1/activations/{id})Offizielles Python SDK
Integrate in seconds using our official open-source Python SDK with automated polling and refund handling:
pip install smskapfrom 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}")Sicherheit, Nachverfolgung und Limits
Die API-Nutzung wird durch konfigurierbare Sicherheitslimits geschützt.
Maximal zulässige Anfragen pro Minute. Liefert bei Überschreitung HTTP 429 und Retry-After.
Maximale Anzahl an Aktivierungen pro Kalendertag; kann bei Bedarf skaliert werden.
Eindeutige ID bei jeder Antwort zur schnellen Zuordnung im Supportfall.
Standardisierte Fehlercodes
Alle Fehler antworten im einheitlichen JSON-Format. Verarbeiten Sie error.code in Ihrer Anwendungslogik.
| HTTP | Fehlercode (error.code) | Bedeutung und Maßnahme |
|---|---|---|
| 400 | invalid_payload | Missing or invalid payload (service_key or country_code outside supported catalog). |
| 400 | insufficient_balance | Account balance is insufficient. Top up balance in the user panel. |
| 400 | cancel_window_expired | Cancellation window expired or SMS code already delivered; cannot be cancelled. |
| 401 | invalid_api_key | Invalid, missing or revoked Bearer API key. |
| 403 | forbidden | Developer application pending approval or suspended. |
| 404 | no_numbers_available | No numbers available right now for this service and country. Please retry shortly. |
| 404 | activation_not_found | The requested activation ID does not exist. |
| 409 | activation_conflict | Conflict detected on activation or duplicate idempotency key. |
| 429 | rate_limit_exceeded | Rate limit exceeded. Wait the number of seconds specified in the Retry-After header. |
| 429 | daily_activation_limit_exceeded | Daily activation quota reached. Contact support to request a quota increase. |
| 503 | service_temporarily_unavailable | Carrier network is temporarily unavailable. Please retry shortly. |