简洁、可靠且透明的短信验证码 API。

三步完成系统集成

提交开发者申请，审核通过后生成 Live API 密钥，即可安全地在后端服务器中调用。

安全 Bearer Token 身份验证

在每次请求中通过 Authorization: Bearer <key> 请求头传递密钥。私密密钥仅在创建时显示一次。

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

账户与余额查询

调用 GET /v1/account 可获取当前余额、货币单位 (TRY) 以及分配的速率与激活配额。

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

标准服务与国家目录

我们的基础设施专注于 3 种高成功率核心服务和 3 个全球主要国家，底层运营商路由引擎会自动分配合适的优质实体卡号码。

号码预订、SMS 查询与退款流程

预订号码、轮询接收验证码，或在规定时限内取消。若未收到验证码，扣减金额将全自动立即退回账户余额。

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

官方 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 ➔

可观察性、配额与安全性

API 调用受到后台可实时监控与调整的安全配额保护。

标准错误代码表

所有错误均以规范的 JSON 结构返回。请在业务代码中针对 error.code 进行处理。