API v1

一个冲刺内将 SMSCodex 集成到您的技术栈

REST 和 Webhook API，具有清晰的授权方案、SDK 和详细日志。每个账户支持高达 1,500 请求/秒，无 SLA 降级。

快速购买文档 Swagger (OpenAPI)申请沙盒密钥

集成如何运作

1. 授权。在控制面板（设置 → API）获取 API 密钥。在每个请求的 X-API-Key 头中传递它。
2. 购买号码。发送 POST /api/v1/marketplace/fast-purchase/api，指定服务、国家和价格限制。响应包含号码、状态和过期时间。
3. 获取验证码。轮询 GET /api/v1/marketplace/orders/{id} 或等待 Webhook。短信到达后，验证码会出现在 last_code 字段中。
4. 完成。通过 POST .../complete 确认订单或通过 .../cancel 取消。未使用的号码在 TTL 后自动释放。

交互式文档

完整的 OpenAPI 规范可在控制面板内的 Swagger UI 中查看。您可以直接在浏览器中测试每个端点。

Swagger (OpenAPI) →

兼容协议 (Legacy GET API)

除了主要 REST API 外，我们还支持兼容的 GET 风格协议——通过单一端点提供 14 个操作。如果您的软件已使用此格式，切换只需几分钟。

基础 URL：smscodex.com/api/v1/stubs/handler_api.php，通过 api_key 参数授权。可用操作：getBalance、getNumberV2、getStatus、setStatus、getCountries、getPrices 等。

完整规范可在 Swagger → "Legacy GET API" 部分中查看。

下载 Postman 合集 (Legacy)

请求示例 (Native API)

curl -X POST https://smscodex.com/api/v1/marketplace/fast-purchase/api \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "service_code": "telegram",
    "country": "RU",
    "price_limit": 1.5,
    "currency": "USD"
  }'

Legacy GET API

# Legacy GET API — один URL, 14 действий
curl "https://smscodex.com/api/v1/stubs/handler_api.php\
?api_key=YOUR_API_KEY&action=getBalance"