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

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

接口长什么样（示例）

• 取号码：POST /api/open/buy，body 传 {"item_key":"openai_21_30","quantity":1}，返回号码 + 接码链接 + 本次扣费。
• 下单防重：POST /api/open/buy 的 body 里带你自己生成的 order_no（幂等键），同一个 order_no 重试只会返回同一笔订单和同一批号码，不会重复扣费。
• 按单号取号：GET /api/open/order?order_no=你的单号（或 ?order_id=本站订单号），返回号码 + 接码链接 + 到期时间。
• 号码列表：GET /api/open/numbers 支持 order_id / min_order_id / page / page_size 筛选与翻页。
• 取验证码：GET /api/open/code?number=号码，返回该号码收到的验证码（没到会等几秒再返回）。
• 换号：POST /api/open/change，号码没收到验证码时可以换一个新号（同一档位单价再扣一次）。
• 查库存：GET /api/open/stock?item_key=...，返回各档位实时可售数量，方便你决定什么时候进货。
• 鉴权：请求头带 X-Api-Key（在「个人资料 / API 文档」里生成），返回 JSON，错误码见接口文档。

适合谁

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

三种批量方式

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

接入建议

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

常见问题