API de vérification SMS simple, fiable et transparente.

Intégrez en trois étapes

Soumettez votre demande, obtenez l'approbation, créez votre clé Live et envoyez des requêtes en toute sécurité depuis votre serveur.

Authentification par Bearer Token

Transmettez votre clé API dans l'en-tête Authorization: Bearer <key> à chaque requête. Le secret ne s'affiche qu'une seule fois.

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

État du Compte et Solde

Interrogez GET /v1/account pour consulter votre solde disponible, la devise (TRY) et les limites configurées.

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

Catalogue Standard des Services et Pays

Notre plateforme se concentre strictement sur 3 services majeurs et 3 pays à très fort taux de livraison.

Réservation de Numéro, Consultation SMS & Remboursement

Réservez un numéro, interrogez le code SMS ou annulez dans les délais impartis. Sans réception du code, le solde est remboursé automatiquement.

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

Intégration avec le SDK Python Officiel

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 ➔

Traçabilité, Limites et Sécurité

L'utilisation de l'API est encadrée par des limites sécurisées configurables.

Codes d'Erreur Standardisés

Toutes les erreurs renvoient une structure JSON standardisée. Traitez le champ error.code dans votre code.