回答 · エラー · デバッグ
オッズAPIのエラーコード
回答： RESTのエラーはHTTPステータスとともに {"error": {"code", "message"}} の形で返ります。よくあるのは 401 invalid_key、403 plan_lacks_ws（Free/Hobbyで /v1/stream に接続）、403 sport_not_in_plan、上限による 429 です。WebSocketでは、4001 キー失効、4002 30秒以内に subscribe なし、4008 低速クライアント、1001 サーバー再起動でクローズされます。一覧：エラー。
早見表#
| コード | 発生箇所 | 対処 |
|---|---|---|
400 invalid_filter | REST、WSの error フレーム | 競技名とマーケット名を確認 |
401 missing_key / invalid_key | REST、WS接続 | 有効な ps_live_ キーを送る |
403 plan_lacks_ws | WS接続 | Builderへ |
403 sport_not_in_plan | REST（WSでは error フレーム） | ダッシュボードで競技を選ぶか、プランを変更 |
403 plan_lacks_history | /v1/closing | BuilderまたはPro |
plan_lacks_raw | WSの error フレーム | format: "raw" はPro限定 |
429 rate_limited | REST | Retry-After の秒数だけ待つ |
429 daily_quota | REST（Free） | 00:00 UTCまで待つか、プランを変更 |
429 connection_limit | WS接続 | 接続を1本閉じる（Builder 3、Pro 10） |
クローズ 4008 | WS | 受信処理を速くするか、購読を絞る |
クローズ 1001 | WS | 再起動：バックオフ付きで再接続 |
WebSocketとクロージング履歴ならBuilder（月額99ユーロ）。3日間のトライアルにはカード登録が必要で、解約しない場合は3日目の後に課金されます。無料のREST：登録。関連：プラン別レート制限。
18歳以上の方を対象とした教育目的のコンテンツです。
よくある質問#
403でソケットは閉じますか？#
プランによる拒否はアップグレード前のHTTPリクエストの段階で起こります。接続中の error フレームでは、必ずしも接続は閉じません。
plan_lacks_wsの本文には何が入っていますか？#
Builderのトライアルを始めるための upgrade_url と、トライアルの条件です。
完全な一覧はどこにありますか？#
docs/errors にあります。