# 错误与限制

身份验证和参数校验可能在执行前拒绝请求。请查阅错误参考，联系支持时保留 request_id。切勿发送密钥或密码。

## 响应 · HTTP

| HTTP | 说明 |
| --- | --- |
| `400 / 422` | 检查参数名称、类型、范围及必填值。 |
| `401` | 在 Authorization 请求头中使用当前有效密钥。 |
| `403` | 检查账户访问、有效权限、验证及 API 来源 IP 允许列表。 |
| `404` | 检查自己的记录 ID；不会公开其他账户记录。 |
| `409` | 重试前重新读取相关 revision/报价并确认原始操作状态。 |
| `429` | 等待 Retry-After 指定时间，再进行有限频率查询。 |
| `5xx / timeout` | 写操作结果不明确不等于失败。请查询同一操作，不要提交新购买或更改。 |

## 错误与限制 · HTTP 429

默认每个自然分钟最多 60 次请求，管理员可另行设置。请读取 capabilities.limits，并在 HTTP 429 时遵守 Retry-After。更新密钥不会清除账户用量。

```http
Retry-After: 15

{
  "ok": false,
  "error": { "code": "RATE_LIMITED" },
  "meta": { "request_id": "000000000000000000000429" }
}
```

## Idempotency-Key

每个预期写操作应保存一个 Idempotency-Key。超时或 HTTP 5xx 不代表失败。请用同一键查询状态，不要为了处理不确定结果而用新键重做操作。

---
[ARNPROXY API](https://docs.arnproxy.com/zh/api-v1/errors)