查询 API 错误和使用限制
根据响应中的错误代码找到处理位置，查询请求大小、超时与用量计量规则。
本页目录
按错误代码处理
| 代码 | 含义 | 处理办法 |
|---|---|---|
| invalid_api_key | 密钥无效 | 买家检查 X-Invokora-Key；遗失时到工作台轮换 |
| endpoint_not_allowed | 套餐无此端点权限 | 核对买家已购套餐及 HTTP 方法、路径 |
| rate_limit_exceeded | 达到短时请求限制 | 按响应中的重置时间等待并降低频率 |
| object_quota_exceeded | Hard 对象额度耗尽 | 查看对象剩余量，等重置或选择合适套餐 |
| bandwidth_payment_required | 免费套餐超过带宽且无付款方式 | 买家到工作台主动开通超额带宽计费 |
| origin_unavailable | 上游未能完成请求 | 商家检查上游可用性、路由和连接 |
判断访问与计量状态
active 表示订阅处于有效状态，但请求仍需通过权限、额度和限流检查；paused 表示访问暂停；canceled 表示已取消并停止新调用。
完整的原始上游响应低于 500 才确认关联对象用量，包括上游 4xx。上游 5xx、失败、超时、不完整响应和客户端中断不确认对象用量。已经转发的请求仍消耗限流窗口，实际传输带宽单独计量。
对象响应头 x-ratelimit-{name}-limit、remaining 和 reset 分别表示额度、剩余量和距重置的秒数。动态 Hard 用量可由在途请求越界，后续请求被阻止，Hard 超额不收费。
请求、带宽与记录限制
| 项目 | 限制或规则 |
|---|---|
| OpenAPI 文件 | 最大 5 MiB；自包含 OpenAPI 3.0.x / 3.1.x |
| 请求与响应正文 | 分别最大 50 MB，商家可设置更小上限 |
| 上游超时 | 1–180 秒 |
| 带宽 | 每订阅周期含请求与响应合计 10 十进制 GB；超出 USD 1/GB |
| 请求日志 | 元数据保留 30 天；不保存 query、headers 或正文 |
| 服务附件 | 每次最多 5 个，单文件 25 MB；终态后最多保留 180 天 |