错误与限流

错误格式

所有错误使用统一公开结构：

{
  "request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "One or more request fields are invalid.",
    "details": [
      {
        "path": "asin",
        "message": "Must be a valid 10-character ASIN"
      }
    ]
  }
}

存在字段级校验信息时会返回 details。

HTTP 状态码

常见错误码包括 INVALID_JSON、VALIDATION_ERROR、API_KEY_REQUIRED、 INVALID_API_KEY、API_KEY_EXPIRED、SUBSCRIPTION_REQUIRED、 SUBSCRIPTION_INACTIVE、ENDPOINT_NOT_INCLUDED、RATE_LIMIT_EXCEEDED、 CONCURRENCY_LIMIT_EXCEEDED、INSUFFICIENT_CREDITS、 USAGE_LIMIT_EXCEEDED、SERVICE_BUSY、SERVICE_TIMEOUT、 SERVICE_UNAVAILABLE、INVALID_PARAMETERS、PREDICTION_UNAVAILABLE、PAGE_NOT_AVAILABLE 和 ASIN_NOT_FOUND。 INVALID_PARAMETERS 表示参数通过了格式校验，但取值被数据源拒绝，最常见的是日期格式与该接口要求不符。 PAGE_NOT_AVAILABLE 表示向一个目前只返回第一页的接口请求了后面的页。这两种情况都不计费。商品详情接口在该 ASIN 没有对应商品时返回 ASIN_NOT_FOUND，这次请求不计费。直连用户的 RPM、并发数和 Credits 按账户汇总， 不能通过创建多个 API Key 获得额外配额。

限流请求头

响应可能包含：

遇到 429、503、504 时应遵循 Retry-After，并使用带随机抖动的指数退避。 参数校验或鉴权失败时，不要在请求内容未改变的情况下直接重试。

调用明细

已登录的直连用户可以在用量页面查看请求元数据。经过脱敏的请求体和最多 20 KB 的响应 内容保留 180 天；密钥和个人字段会在保存前自动脱敏。