SMSPing

SMSPING · 使用指南

短信接收 API：认证、购买与订单查询

SMSPing 开发者接口位于 /api/customer。目录与报价可公开读取；订单、余额等业务接口使用所属账户的 API 密钥认证。开始接入前，请在开发者文档中核对当前字段、错误码和限额，将购买结果与订单状态纳入自己的流程。

生成密钥并在服务端认证

登录后，在账户设置的 API 管理中生成密钥。完整密钥只显示一次，请保存到服务端安全配置，通过 Authorization: Bearer <API_KEY> 请求业务接口。不要将密钥放入网页代码或 URL。重置、停用密钥或修改密码、邮箱后，旧密钥会失效；密钥只访问所属账户数据。

先报价，再幂等创建购买订单

先查询 GET /api/customer/catalog，再按返回的服务与国家 ID 查询 /api/customer/catalog/offers。POST /api/customer/orders 提交 country、service、operator、最新 expectedPrice 和 idempotencyKey。同一次购买重试必须保留原键及原参数；价格变动时先刷新报价并确认新费用。购买会扣除真实余额。

查询短信并处理限流与最终状态

HTTP 200 不代表号码已成功分配，先检查 data.status；若为 review，请保留订单编号并查询原订单或联系支持。通过 GET /api/customer/orders/:id 查询短信，按文档建议至少间隔 5 秒。当前限额为每账户每分钟 60 次，遇到 429 按 Retry-After 等待。收到短信后可完成；等待期间可申请取消。退款仍需确认取消或超时且未收码，并核对最终状态与 refunded 字段。

常见问题

读取服务目录需要 API 密钥吗？

目录和报价接口可公开读取。创建订单、查询自己的短信、余额与流水等业务接口需要 Authorization 请求头中的 Bearer 密钥，具体接口请查看开发者文档。

购买请求超时后，应该换一个幂等键重试吗？

同一次购买应保留原幂等键与参数，并核对已有订单。更换键可能变成新的购买；只有确认发起新的独立操作时才使用新键。

准备开始使用？

打开平台，查看当前服务、国家、可用号码和价格。购买前确认目标服务是否接受您选择的号码类型。

打开短信接收平台