看看它如何运作
操作演示 · 虚构示例数据
创建服务器密钥
在开发者页面创建 API 密钥并保存在服务器。请求范围为自己的账户、钱包与订单；不要放入公开前端代码。
此演示不会更改您的账户。
阅读全部步骤
- 创建服务器密钥
在开发者页面创建 API 密钥并保存在服务器。请求范围为自己的账户、钱包与订单；不要放入公开前端代码。
- API 密钥
- ••••••••
- 范围
- 仅此账户与商店
- 使用实时接口规范
使用自己商店主机上的开发者文档与模式，以 X-API-Key 或 Bearer 认证。构造购买前读取余额、服务与租期。
- 基础 URL
- https://sms.red/api/v1/developer
- 认证
- X-API-Key: <server-held key>
- 购买前读取
- 余额 → 服务 → 租期
- 使用新的幂等键
新购买须使用新键：8–128 个 ASCII 字母、数字、下划线或连字符。设置毫秒租期和已批准报价的 maxPrice 上限。
- 幂等键
- demo-purchase-1042
- 请求字段
- durationMs · maxPrice
- 恢复不明确响应
先查询购买尝试或已拥有订单。同一次购买重试使用同一幂等键；新键可能产生另一笔扣款。
- 现有尝试
- demo-purchase-1042
- 下一操作
- 查询尝试 → 重试时复用同一键
- 处理错误与轮换密钥
401：检查缺失、停用、轮换或错误商店的密钥。404：检查所有权或可用性。400：检查字段、余额与价格上限。可在控制台停用、删除或重新生成密钥；仅支持文档列出的 API 操作。
- 401
- 检查密钥与商店
- 404
- 检查所属资源／库存
- 400
- 检查请求、余额与上限
创建和保护密钥
打开开发者和 API 密钥，创建带名称的密钥并安全保存。调用限定在该商店账户的钱包与订单，不提供管理员权限或请求切换账户。
禁用、删除或重新生成撤销旧凭据。重新生成后旧密钥失效。保存在服务器，不放公开浏览器代码、截图或仓库。
阅读实时接口
SMS.Red 基础地址为 https://sms.red/api/v1/developer，伙伴商店使用自己的域名。认证支持 X-API-Key 或 Authorization: Bearer YOUR_API_KEY。按交互文档和当前 schema，而非猜字段。
购买前读取余额与服务。列表区分 otp、rent、国家、库存和期限，期限单位毫秒。购买选择实际服务 ID、国家、期限和价格上限；可选字段依操作文档。
安全重试购买
每项新购买用新 Idempotency-Key，重试同购买保留相同键。支持 8–128 个 ASCII 字母、数字、下划线或连字符。超时后先查文档中的购买尝试，再决定新订单。同键改变请求可能冲突。
GET /api/v1/developer/balance
X-API-Key: YOUR_API_KEY示例是占位密钥的读取，不是真凭据。付费请求按实时例子。通过文档接口读取自有订单和消息，取消仍需资格与确认。
错误和消息集成
401 可能是缺失、禁用、轮换或错误商店密钥；404 是不可用或非自有数据；400 是校验、资金或价格问题。不明确服务器结果时保留购买键并查尝试，不盲目换键重买。
入站消息用 Webhook。不要假设 API 包含每个面板操作，逐项检查合同。
需要账户帮助？
打开支持中心