> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nonce.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 速率限制与重试

> 处理限流和临时故障，避免重复执行操作。

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

## 请求受限

收到 `429 Too Many Requests` 时，应暂停请求后再重试。如果响应包含 `Retry-After`，按其中指定的时长或时间等待；否则逐步延长重试间隔，并加入随机延迟，同时限制重试次数。

持续高频调用的相关问题可联系 [hi@nonce.app](mailto:hi@nonce.app)，说明调用接口、预计请求频率和常见响应大小，请勿附带凭据。

## 临时故障

读取请求遇到网络故障或临时服务端错误时，可以采用指数退避重试，并限制重试次数。只读的 POST 搜索请求也适用，是否重试应根据操作本身判断。

超时不代表写入失败。重复提交创建 task batch 的请求，可能向矿机下发两次相同操作。再次提交前，应通过 [List Task Batches](/api-reference/v2/task-batches/list-task-batches) 检查 task batch 是否已经存在，再决定是否重试。

## 其他错误

对于 400、401、403 或 404 响应，应先检查请求、凭据和资源访问权限，避免自动重试。访问错误的含义见[认证与访问权限](/zh/api-guide/v2/authentication#访问错误)，错误格式见[请求与响应](/zh/api-guide/v2/requests)。