API sencilla, confiable y transparente para verificación SMS.

Integra en tres sencillos pasos

Envía tu solicitud, obtén la aprobación, genera tu clave Live y comienza a operar desde tu propio servidor backend.

Autenticación Segura con Bearer Token

Envía tu clave en la cabecera Authorization: Bearer <key> en cada petición. La clave secreta solo se muestra una vez al generarla.

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

Estado de Cuenta y Saldo

Consulta GET /v1/account para verificar el saldo disponible, la moneda (TRY) y los límites configurados.

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

Catálogo Estándar de Servicios y Países

Nuestra infraestructura está enfocada en 3 servicios clave y 3 países globales con la más alta tasa de entrega.

Reserva de Números, Consulta de SMS y Reembolso

Reserva un número, consulta el código SMS recibido o cancela en plazo. Si el código no llega, el saldo se reembolsa al instante.

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

Integración con SDK Oficial de 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 ➔

Observabilidad, Límites y Seguridad

El consumo de la API está protegido por límites configurables en tiempo real.

Códigos de Error Estandarizados

Todos los errores responden con un esquema JSON estandarizado. Procesa el valor de error.code.