DEVELOPER API

代理商 REST API

身份与幂等

基础路径 /api/v1。仅在代理商服务端使用 Bearer API Key，按 scope 授权。任务、财务和配置 POST 请求需要 8–128 字符的 Idempotency-Key。相同键配不同请求返回 409。

GET /api/v1/wallet
POST /api/v1/sms/tasks
GET /api/v1/sms/tasks/:id/messages
POST /api/v1/sms/tasks/:id/extend
POST /api/v1/reseller/cdk/batches

下游通知仅包含任务与消息 ID。X-Webhook-Signature 为 v1= 加上 HMAC-SHA256(timestamp + '.' + exact body) 的十六进制表示。接收方须检查时间戳、常量时间验签，并按 X-Webhook-Id 去重。

终端验证：收到 endpoint.verification 的 challenge 后，返回 JSON signature = hex HMAC-SHA256(challenge, endpoint secret)。出站只允许公网 HTTPS:443，禁止重定向。

真实 UKSIM 上游接入与支付仍处于 PRODUCTION_BLOCKED。