レート制限とクォータ
API 利用は 分単位のレート制限 と チャネル別の日次クォータ (課金ユニット) により制限されます。制限は、想定される取引量に基づいてアプリのオンボーディング時に設定されます。Acceptable use を参照してください。
構造化された制限とヘッダー: data/rate-limits.json。
分単位のレート制限 {#rate-limits}
デフォルト: API キーごとに 60 requests/minute (プランにより変動)。超過すると HTTP 429 と RATE_LIMIT_EXCEEDED を返します。
日次チャネルクォータ (課金ユニット) {#daily-quota}
多くのルートは、チャネル別 (1688、Taobao) の日次上限に対して 課金ユニット を消費します。例:
| ルート | 一般的なユニット |
|---|---|
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}
成功した課金対象呼び出しには、以下が含まれる場合があります。
| Header | 説明 |
|---|---|
X-Quota-Billable-Units | このリクエストで消費したユニット |
X-Quota-Channel | ユニットが課金されたチャネル (例: 1688) |
x-request-id | リクエスト相関 ID (すべてのルート) |
プラットフォーム容量 {#platform-quota}
まれに、共有 upstream 容量が一時的に利用できないことがあります → PLATFORM_QUOTA_EXCEEDED (429)。後で再試行するか、サポートに連絡してください。
クライアントへの推奨 {#handling}
- ビジネスルールが許す範囲で商品詳細レスポンスをキャッシュします。
upload-image後は再アップロードではなくimage_idの再利用を優先します。429ではバックオフし、error.request_idを確認してください。Errors を参照。- developer portal の利用状況ダッシュボードで使用量を監視します。