SMSKAP DEVELOPER API

واجهة برمجة بسيطة وموثوقة للتحقق عبر SMS.

توفر واجهة SMSKap أرقام شرائح حقيقية لخدمات واتساب وواتساب أعمال وتلغرام بأسعار الفهرس القياسية الشفافة مع ضمان استرداد تلقائي.

العنوان الأساسي للواجهةhttps://api.smskap.com/v1

طلب API تنزيل OpenAPI JSON قراءة الدليل

01 · البدء السريع

أكمل عملية الدمج في ثلاث خطوات

أرسل طلب المطور، أنشئ مفتاحك بعد الموافقة، وابدأ بالاتصال الآمن من خادمك.

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

أرسل مفتاح API في ترويسة Authorization: Bearer مع كل طلب. يظهر المفتاح السري مرة واحدة فقط.

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

لا تضع مفتاح API في كود المتصفح أو مستودعات الكود العامة أبداً.

03 · الحساب والرصيد

حالة الحساب والرصيد

يعرض GET /v1/account الرصيد الحالي والعملة (TRY) والحدود المحددة لحسابك.

GET/v1/accountيلزم مفتاح معتمد

{
  "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 · واجهة التفعيل

شراء الرقم واستعلام الرمز واسترداد الرصيد

احجز رقماً، استعلم عن رمز 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}قراءة الرمز (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 الرسمية

مكتبة Python الرسمية

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 · الحدود والأمان

الحدود وقابلية التتبع والأمان

يخضع الاستخدام لقيود أمان قابلة للإدارة الفورية.

حد الطلبات بالدقيقة

عدد الطلبات المسموح بها بالدقيقة، يرجع 429 مع Retry-After عند التجاوز.

حصة التفعيل اليومية

الحد الأقصى لعمليات التفعيل في اليوم الواحد، ويمكن رفعه حسب الطلب.

معرف الطلب (request_id)

رمز فريد مع كل استجابة لتتبع العمليات وتقديم الدعم الفني.

منع التكرار (Idempotency-Key): ترويسة UUID إلزامية في POST تمنع الخصم المزدوج عند انقطاع الاتصال.

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.