レート制限とエラー
レート制限、レスポンスヘッダー、エラーコードを理解する。
プラン別レート制限
| プラン | 日次制限 | 秒間 |
|---|
| Free | 200 | 1 req / 3s |
| Trader | 10,000 | 1 req / s |
| Business | 100,000 | 3 req / s |
レスポンスヘッダー
すべてのAPIレスポンスにはレート制限ヘッダーが含まれており、使用量を追跡できます。
X-RateLimit-Limit現在のウィンドウで許可される最大リクエスト数。
X-RateLimit-Remaining現在のウィンドウで残っているリクエスト数。
ベストプラクティス
- •レスポンスをキャッシュ — カードデータと価格は毎秒変わりません。少なくとも5分間キャッシュしてください。
- •バッチ検索を使用 — 個別のコールではなく
idsパラメータを使用して1リクエストあたり最大20枚のカードを取得。 - •指数バックオフを実装 — 429を受け取ったら、待機してから増加する遅延(1秒、2秒、4秒)でリトライ。
- •レート制限ヘッダーを監視 —
X-RateLimit-Remainingを確認して、制限に達する前にプロアクティブに速度を落とす。