美国接码 API：取号码 / 取验证码 / 批量下单

需要几十上百个美国号码、并且要自动取验证码的场景，靠手工操作是不现实的。sms688 的接码 API 提供取号码、取验证码、换号、查库存四个动作，返回 JSON，可以直接接进你的系统或下游站点。

接口长什么样（示例）

• 取号码：POST /api/open/buy，body 传 {"item_key":"openai_21_30","quantity":1}，返回号码 + 接码链接 + 本次扣费。
• 取验证码：GET /api/open/code?number=号码，返回该号码收到的验证码（没到会等几秒再返回）。
• 换号：POST /api/open/change，号码没收到验证码时可以换一个新号（同一档位单价再扣一次）。
• 查库存：GET /api/open/stock?item_key=...，返回各档位实时可售数量，方便你决定什么时候进货。
• 鉴权：请求头带 X-Api-Key（在「个人资料 / API 文档」里生成），返回 JSON，错误码见接口文档。

适合谁

• 需要批量注册与验证账号的工作室。
• 自己做接码站、需要从上游取号码与验证码的下游网站。
• 需要把收码能力接进自有系统的团队。

三种批量方式

• 批量下单：号码市场支持多号段多选、一次下单多个号码，可以按项目批量采购。
• 批量下载：购买记录与我的号码都支持整批导出 txt，包含号码与接码链接。
• API 对接：用账号的 API Key 调用接口获取号码与短信，适合自动化系统。

美国接码api 3 步接入（复制就能跑）

把 KEY 换成你后台 API 文档里的 Key，下面三步就是完整闭环：

1. 取号：POST /api/open/buy，传 item_key（项目档位）、quantity、可选 prefixes（号段）→ 返回 numbers[]（号码 + 接码链接）。
2. 等验证码：GET /api/open/code?number=号码&wait=20，长轮询，收到码立刻返回 code；也可以 order_id 取整单最新一条。
3. 没收到就换号：POST /api/open/change（仅卡密兑换的号码支持）或重新取号；换号前建议先查一次短信，避免号码其实已经收码。

curl -H "X-Api-Key: sk_你的Key" "https://sms688.com/api/open/buy" \
  -X POST -H "Content-Type: application/json" \
  -d '{"item_key":"openai_21_30","quantity":1,"prefixes":["1615"]}'

curl -H "X-Api-Key: sk_你的Key" "https://sms688.com/api/open/code?number=1615xxxxxxx&wait=20"

取号即扣费、没取到号不扣费；余额不足返回 402，库存不足返回 409，参数错误返回 400，具体见 API 文档。

接入建议

• 先小批量测试目标平台的收码成功率，再扩大规模。
• 做好号码与账号的对应关系记录，避免号码到期导致账号失联。
• 对长期使用的号码提前续费，比到期后重新买号更划算。

常见问题