Web3 SMS

Web3 SMS

API 文档

号码、验证邮箱、钱包与 SMS-Activate 兼容接口说明。

下载 OpenAPI 3.1

身份认证

REST 请求使用 Bearer API Key。创建订单还必须发送 Idempotency-Key 请求头。

Authorization: Bearer w3sms_live_...
Idempotency-Key: your-unique-request-id

REST v1

GET/api/v1/balance
GET/api/v1/offers
GET/api/v1/emails/domains
POST/api/v1/emails
POST/api/v1/emails/batch
GET/api/v1/emails/{id}
DELETE/api/v1/emails/{id}
POST/api/v1/emails/{id}/reorder
POST/api/v1/activations
GET/api/v1/activations/{id}
POST/api/v1/activations/{id}/cancel
POST/api/v1/rentals
GET/api/v1/rentals/{id}/messages
POST/api/v1/payments
GET/api/v1/webhook-endpoints

SMS-Activate

GET /stubs/handler_api.php?api_key=...&action=getBalance

支持目录查询、接码、重新激活、延长租期、租号、状态查询、历史记录、完成和取消等操作。

Webhook 签名

使用 HMAC-SHA256 校验 timestamp + "." + 原始请求正文,并按 event ID 去重。

v1 = HMAC_SHA256(secret, timestamp + "." + raw_body)