# 错误与重试

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

## 查看响应

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

| 状态码 | 建议操作 |
| --- | --- |
| `401` | 检查密钥是否有效、已过期或被撤销 |
| `403` | 检查访问权限、范围、允许的 IP 和支出限制 |
| `404` | 检查编号及其是否属于当前工作空间 |
| `409` | 先刷新资源或报价，再决定下一步 |
| `422` | 根据错误代码修正请求字段 |
| `429` | 按 `Retry-After` 等待后再请求 |
| `5xx` 或无响应 | 重试写入前先检查原操作 |

## 重试同一次操作

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

不要因为超时而生成新标识。同一标识配合不同请求体会产生冲突。是否需要该请求头，请查看[API 参考](/zh-cn/docs/api)。

## 流量购买需要处理

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

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

## 遵守请求限额

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

## 保留数值精度

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