⚡5 分钟快速接入 SimSmsBox API

本教程带你在 5 分钟内跑通 SimSmsBox 的核心流程：取号 → 收码 → 取消（可选）。

准备工作

1. 注册并登录用户后台。
2. 在「钱包」充值少量余额（用于按单扣费）。
3. 在「API Key」页面创建一个 Key，形如 psk_xxxxxxxx。

所有接口都通过请求头 X-API-Key 鉴权。

第一步：查询某国家可用应用与价格

curl "https://api.simsmsbox.com/api/sms/shop/market?country=US&cardKind=physical" \
  -H "X-API-Key: psk_xxxxxxxx"

返回该国家下各应用（如 telegram）的实时价格与库存，其中的 service 字段就是下单要传的服务代码。

第二步：取号（创建订单）

curl -X POST https://api.simsmsbox.com/api/sms/orders/purchase \
  -H "X-API-Key: psk_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"service":"telegram","country":"US","cardKind":"physical","rentDays":30}'

返回（含取码地址凭证 apiBindingKey）：

{ "orderId": 19, "phone": "+1xxxxxxxxxx", "status": "waiting", "apiBindingKey": "psk_orderkey_xxx" }

第三步：取码（用取码地址，推荐）

取号后，用上一步返回的 apiBindingKey 调用固定的取码地址 /api/sms/record 实时拉取验证码。该地址在号码有效期内一直有效、可重复调用，且无需再带 X-API-Key（key 本身即授权）：

# 极简文本：已收到 -> YES|123456，未到 -> NO|
curl "https://api.simsmsbox.com/api/sms/record?key=psk_orderkey_xxx&format=txt"

# 或默认 JSON（status=YES/NO，data 含整条短信与 codeValue）
curl "https://api.simsmsbox.com/api/sms/record?key=psk_orderkey_xxx"

收到后返回示例：

YES|123456

取码地址在订单有效期内持续可用，重复接收同一应用的验证码也从这里取。若只想查订单状态/有效期，可另用 GET /api/sms/orders/19（其中 latestCode 仅为便捷字段，非取码主渠道）。

第四步：取消订单（可选）

没收到码想换号时可取消，未收码会自动退款：

curl -X POST https://api.simsmsbox.com/api/sms/orders/19/cancel \
  -H "X-API-Key: psk_xxxxxxxx"

下一步

• 学习如何自动轮询：自动取号与轮询
• 学习模板化取码：自定义取码 URL 与模板化返回