Sade, Güvenilir ve Şeffaf SMS Onay Entegrasyonu.

Üç adımda entegrasyonu tamamlayın

Geliştirici başvurunuzu yapın, hesabınız onaylandığında API anahtarınızı oluşturun ve güvenli sunucunuzda kullanmaya başlayın.

Bearer Token ile Güvenli Erişim

Her istekte API anahtarınızı Authorization: Bearer <key> başlığıyla gönderin. Üretilen gizli anahtar yalnızca oluşturma anında bir kez gösterilir.

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

Bakiye ve Hesap Durumu

GET /v1/account uç noktası ile hesap bakiyenizi, para birimini (TRY), tanımlı dakikalık ve günlük istek limitlerinizi sorgulayabilirsiniz.

{
  "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"
}

Standart Servis ve Ülke Kataloğu

API sistemimiz sadece en yüksek başarı oranına sahip 3 ana servis ve 3 küresel ülkeye odaklanmıştır. Operatör routing altyapımız arka planda en kaliteli fiziksel SIM hatlarını otomatik olarak seçer.

Numara Tahsisi, SMS Sorgulama ve İade Akışı

Numara rezerve edin, gelen SMS kodunu sorgulayın veya kod gelmezse süresi içinde iptal edin. İptal edilen ve SMS kodu teslim edilmeyen aktivasyonların ücreti anında bakiyenize iade edilir.

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"
}

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"
}

Resmi Python SDK ile Entegrasyon

Python uygulamalarınızda hazır açık kaynak kütüphanemizi kullanarak saniyeler içinde SMS doğrulama başlatabilirsiniz:

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 Reposu & Kaynak Kodları ➔

İzlenebilirlik, Limitler ve Güvenlik

API kullanımınız panel üzerinden gerçek zamanlı kontrol edilebilir limitlere tabidir.

Standart Hata Kodları ve Yanıt Formatı

Tüm hatalar standart JSON sözleşmesiyle döner. Uygulamanız error.code anahtarını baz alarak işlem yapmalıdır.