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