速率限制与重试 - Nonce

API 设有速率限制。应用应控制请求频率和并发量，对较大的数据集合使用分页，并缓存变化较少的数据。

请求受限

收到 429 Too Many Requests 时，应暂停请求后再重试。如果响应包含 Retry-After，按其中指定的时长或时间等待；否则逐步延长重试间隔，并加入随机延迟，同时限制重试次数。持续高频调用的相关问题可联系 hi@nonce.app，说明调用接口、预计请求频率和常见响应大小，请勿附带凭据。

临时故障

读取请求遇到网络故障或临时服务端错误时，可以采用指数退避重试，并限制重试次数。只读的 POST 搜索请求也适用，是否重试应根据操作本身判断。超时不代表写入失败。重复提交创建 task batch 的请求，可能向矿机下发两次相同操作。再次提交前，应通过 List Task Batches 检查 task batch 是否已经存在，再决定是否重试。

其他错误

对于 400、401、403 或 404 响应，应先检查请求、凭据和资源访问权限，避免自动重试。访问错误的含义见认证与访问权限，错误格式见请求与响应。