SMSKAP DEVELOPER API

सरल, सुरक्षित और पारदर्शी SMS सत्यापन API।

SMSKap API स्वीकृत डेवलपर खातों को WhatsApp, WhatsApp Business और Telegram के लिए भौतिक सिम आधारित नंबर पारदर्शी मानक कैटलॉग कीमतों पर प्रदान करता है।

API बेस URLhttps://api.smskap.com/v1

API आवेदन OpenAPI JSON डाउनलोड करें गाइड पढ़ें

01 · त्वरित शुरुआत

तीन चरणों में इंटीग्रेशन पूरा करें

आवेदन जमा करें, स्वीकृति के बाद अपनी Live API कुंजी बनाएं और सर्वर से सुरक्षित अनुरोध भेजना शुरू करें।

1आवेदन करें

Submit your developer form to begin the review process.

2स्वीकृति की प्रतीक्षा

Get notified once your account is reviewed and approved.

3कुंजी बनाएं

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

02 · प्रमाणीकरण

Bearer Token प्रमाणीकरण

प्रत्येक अनुरोध में Authorization: Bearer <key> हेडर भेजें। सीक्रेट कुंजी केवल निर्माण के समय एक बार दिखाई जाती है।

curl https://api.smskap.com/v1/account \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx"

अपनी API कुंजी को कभी भी ब्राउज़र कोड या सार्वजनिक रिपॉज़िटरी में न रखें।

03 · खाता और बैलेंस

खाता स्थिति और बैलेंस

GET /v1/account से अपना उपलब्ध बैलेंस, मुद्रा (TRY) और सीमाएं प्राप्त करें।

GET/v1/accountस्वीकृत Live कुंजी आवश्यक

{
  "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 · कैटलॉग और कीमतें

मानक सेवा और देश कैटलॉग

हमारा सिस्टम 3 मुख्य सेवाओं और 3 देशों पर केंद्रित है ताकि उच्चतम वितरण दर सुनिश्चित की जा सके।

Supported Services

WhatsApp whatsapp

WhatsApp Business whatsapp-business

Telegram telegram

Supported Countries

Türkiye (+90) tr

United States (+1) us

United Kingdom (+44) gb

पारदर्शी कैटलॉग मूल्य निर्धारण

कोई छिपा हुआ शुल्क या मनमाना मार्जिन नहीं। सभी कीमतें मानक कैटलॉग दरों पर आधारित हैं, और उच्च मात्रा वाले खातों के लिए एडमिन पैनल से छूट प्रतिशत सेट किया जा सकता है।

GET/v1/countriesसक्रिय देश (TR, US, GB)

GET/v1/servicesसक्रिय सेवाएं (WhatsApp, WhatsApp Business, Telegram)

GET/v1/offersलाइव कीमतें और उपलब्धता

05 · सक्रियण API

नंबर आवंटन, SMS पूछताछ और रिफंड

नंबर बुक करें, SMS कोड की प्रतीक्षा करें या रद्द करें। कोड न आने पर बैलेंस तुरंत और स्वचालित रूप से वापस कर दिया जाता है।

POST/v1/activationsनंबर बुक करें (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 कोड पढ़ें (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}रद्द और रिफंड (DELETE /v1/activations/{id})

06 · आधिकारिक PYTHON SDK इंटीग्रेशन

आधिकारिक 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 · सीमाएं और सुरक्षा

सुरक्षा और सीमाएं

API उपयोग नियंत्रण और सुरक्षा सीमाओं द्वारा प्रबंधित किया जाता है।

प्रति मिनट अनुरोध सीमा

प्रति मिनट अधिकतम अनुरोध। सीमा पार होने पर 429 और Retry-After मिलता है।

दैनिक सक्रियण सीमा

एक दिन में अधिकतम सक्रियण, जिसे आवश्यकतानुसार बढ़ाया जा सकता है।

अनुरोध ID (request_id)

समर्थन और ट्रैकिंग के लिए प्रत्येक उत्तर में एक अद्वितीय ID शामिल होती है।

Idempotency-Key: नेटवर्क त्रुटियों में दोहराव से बचने के लिए POST अनुरोधों में आवश्यक UUID।

08 · त्रुटि कोड

मानक त्रुटि कोड

सभी त्रुटियां मानक JSON प्रारूप में लौटाई जाती हैं। अपने कोड में error.code का उपयोग करें।

HTTP	त्रुटि कोड (error.code)	विवरण और उपाय
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.