指南

错误与重试

安全恢复失败请求，避免重复购买。

点击接口可编辑请求并查看响应。

查看响应

错误响应包含 code 和 request_id，请保留用于排查。202 表示已受理，请使用返回的编号查询完成状态。

对于需要 Idempotency-Key 的接口，为新操作生成一次标识，并与原请求体一起保存。重试时复用两者。成功操作的重复请求会返回原结果，不会再次从钱包扣款。

不要因为超时而生成新标识。同一标识配合不同请求体会产生冲突。是否需要该请求头，请查看API 参考。

DYNAMIC_GRANT_FAILED 或 DYNAMIC_GRANT_UNKNOWN 可能包含购买记录。读取 GET/dynamic/purchases/{id}，并向支持提供购买编号。使用原标识重复购买请求不会重新启动激活。

支持人员可以审核购买。客户 API 密钥不能自行重试激活，也不能取消并退款。

每个密钥每分钟最多 120 次请求。遇到 429 请遵循 Retry-After，状态不变时适当降低轮询频率。支持的事件可以用 Webhook 替代频繁轮询。

金额是人民币分的整数字符串，请使用整数运算或十进制库。时间戳使用 UTC。余额不可用时为 null。请逐页读取分页列表，获取完整结果。