REST API v1

DogeSMS 控制 API 文档

使用统一的 /api/control 接口即可自动化调用号码库存、取号、收码、取消、复用、租号等功能。支持 OAuth2 Client Credentials 或 API Key 签名，所有写操作需要传递 Idempotency-Key。

查看接口参考下载 Postman Collection

鉴权

• 推荐使用 OAuth2 Client Credentials，获取 access_token 后 2 小时过期。

• 也支持静态 API Key，需在 HTTP Header 中传递 X-API-Key。

• 访问控制台可随时刷新密钥，支持 IP 白名单。

限流 & 幂等

• 默认限流：每秒 10 次写操作、每秒 30 次读操作。

• 使用 Idempotency-Key header 可避免重复扣费，建议每笔交易生成唯一 UUID。

• 返回 HTTP 429 时请指数退避后重试。

核心接口

以下为常用接口示例，完整列表请查阅 OpenAPI 文件。

Method	Path	说明	常见响应

号码请求示例

发送 POST /api/control/activations 时的请求体与响应 JSON。

POST /api/control/activations
Headers:
  Authorization: Bearer <token>
  Idempotency-Key: 73b7-...-ff2

Body:
{
  "serviceCode": "whatsapp",
  "countryCode": "US",
  "reuse": true
}

Response 200:
{
  "requestId": "act-123",
  "number": "+1 650 555 0101",
  "expiresAt": "2024-03-18T08:10:00Z",
  "canReuseUntil": "2024-03-18T08:30:00Z"
}

支持的服务与国家

当前开放 0 种服务、0 个国家/地区。

技术支持

文档最近更新：刚刚。若需企业级接入或高并发配额，请直接与商务团队联系。