接码 API

接口

GET /api/v1/cdk 查询剩余次数、当前号码和近期订单。

POST /api/v1/numbers 获取号码；同一 CDK 已有进行中订单时返回原订单，不重复购买。取号预留一次，首次短信才扣一次。

GET /api/v1/numbers/{id} 查询号码和短信，推荐每 5 秒一次。验证码为字符串，保留前导零。

POST /api/v1/numbers/{id}/change 取消未收码订单，需取号满 120 秒。确认取消后释放次数，再调用取号接口获得新号码。

POST /api/v1/numbers/{id}/reuse 有效期内继续查询同一号码，不触发付费重新激活。

响应与状态

{"order":{"id":"订单ID","state":"waiting","phone":"+1…","created":1790000000000,"expires":1790001200000,"cancelAfter":1790000120000,"messages":[],"charged":false},"cdk":{"quota":3,"used":0,"held":1,"available":2}}

waiting 等待短信；received 收码已扣次；cancelled / refunded 已取消或退款；closed 已结束；uncertain / cancel_pending / refund_pending 等待上游核对。待核对期间不得当作退款成功。

失败响应：{"error":"提示信息"}。HTTP 401 检查 CDK，409 等待订单状态变化，429 按 Retry-After 重试，502 / 503 稍后再查询。不要因取号请求超时连续重复购买。