速率限制与配额
API 使用量受每分钟速率限制和按渠道每日配额（计费单元）约束。限额在应用接入时根据预期交易量设定 — 见 可接受使用。
结构化限额与响应头：data/rate-limits.json。
每分钟速率限制 {#rate-limits}
默认：每个 API Key 60 次/分钟（以套餐为准）。超出 → HTTP 429，错误码 RATE_LIMIT_EXCEEDED。
每日渠道配额（计费单元） {#daily-quota}
许多路由会消耗计费单元，计入各渠道（1688、淘宝）的每日上限。示例：
| 路由 | 典型单元数 |
|---|---|
POST /v1/products/detail | 1 |
POST /v1/products/search | 2 |
POST /v1/products/upload-image | 2 |
POST /v1/orders/preview、create | 权重更高 — 见套餐说明 |
每日上限用尽 → HTTP 429，错误码 QUOTA_EXCEEDED。GMV 增长后可联系 HIOBuy 提升限额。
响应头 {#response-headers}
成功的计费请求可能包含：
| 响应头 | 说明 |
|---|---|
X-Quota-Billable-Units | 本次请求消耗的单元数 |
X-Quota-Channel | 计费所属渠道（如 1688） |
x-request-id | 请求关联 ID（所有路由） |
平台容量 {#platform-quota}
极少数情况下，共享上游容量可能暂时不可用 → PLATFORM_QUOTA_EXCEEDED（429）。请稍后重试或联系支持。
客户端建议 {#handling}
- 在业务规则允许时缓存商品详情响应。
- 优先在
upload-image后复用image_id，避免重复上传。 - 遇到
429时退避重试；读取error.request_id— 见 错误码。 - 在开发者门户的使用量面板中监控用量。