验证
在账户设置中创建或轮换您的密钥。在授权标头中发送它。完整密钥仅显示一次；SMSREC 仅存储其加密哈希。
Authorization: Bearer smsrec_live_YOUR_API_KEY
将密钥保存在您的服务器上。切勿将其嵌入到浏览器或移动应用代码中。
错误、限制和幂等性
响应是 JSON 格式，包含一个 ok 布尔值。当前限制是每个 API 密钥每分钟 60 个请求。购买请求需要唯一的幂等性密钥，以防网络重试无法购买相同的号码两次。
{
"ok": false,
"error": {"code": "insufficient_balance", "message": "Not enough balance."}
}
GET/api/v1/balance
返回当前账户余额。
curl https://smsrec.com/api/v1/balance \
-H "Authorization: Bearer $SMSREC_API_KEY"
GET/api/v1/services
返回所有服务及其当前最低价格的库存情况。
GET/api/v1/prices?service=telegram
返回最多 500 个当前服务-国家报价。提供服务、国家或两者。 每个报价包括 success_rate：成功短信交付的百分比，或未知时为 null。
POST/api/v1/activations
service 必需 — 来自 services 端点的服务代码country 必需 — 来自 prices 端点的国家代码Idempotency-Key 必需的标头 — 此购买尝试的唯一值curl -X POST https://smsrec.com/api/v1/activations \
-H "Authorization: Bearer $SMSREC_API_KEY" \
-H "Idempotency-Key: order-2026-0001" \
-H "Content-Type: application/json" \
-d '{"service":"telegram","country":"indonesia"}'
GET/api/v1/activations/{id}
每 3–5 秒轮询一次。短信到达时，状态变为 received，code 字段包含验证码。
{
"ok": true,
"activation": {
"id": 42,
"phone": "+628123456789",
"status": "received",
"code": "482913",
"price_usd": "0.68"
}
}
POST/api/v1/activations/{id}/cancel
取消等待中的激活并将其价格退款到您的 SMSREC 余额。已接收的激活不退款情况下完成。
curl -X POST https://smsrec.com/api/v1/activations/42/cancel \
-H "Authorization: Bearer $SMSREC_API_KEY"