← すべてのガイド
このページの内容
  1. ホーム
  2. ガイド
  3. Pokerai API のエラーと再試行はどのように処理すればよいですか？
ガイド ここから始める · 02/06 プラットフォーム 7 分 中級

Pokerai API のエラーと再試行はどのように処理すればよいですか？

まずHTTPステータスと現在の操作仕様を確認してください。文書化された400および401レスポンスの原因を修正し、429ではクォータ枯渇とソルバー容量を区別し、再試行回数やSLAを想定せず、該当する一時的な5xxケースのみ再試行してください。

更新 メンテナンス担当 Pokerai API

直接の回答: 呼び出した操作については、現在の リファレンス または OpenAPIスナップショット を使用してください。共有の公開 Error スキーマは error を文書化しており、message を含む場合があります。公開されていないエラーコードの語彙や、すべての操作で同一のレスポンスフィールドがあると推測しないでください。

クイック情報

エラーの形式公開されている共有の Error スキーマには error があり、message が含まれる場合があります。
400 / 401該当する操作では、400 は無効な入力または欠落しているフィールドを文書化しており、401 は欠落している、または無効なAPIキーを文書化しています。
429該当する操作では月間クォータの枯渇が文書化されています。すべてのソルバーホストがビジー状態の場合、ソルバーのスケジューリングでも { "status": "busy" } が返されることがあります。
5xx該当する一部の操作では、一時的に利用できないバックエンド（502）または再試行可能なupstream_unavailableレスポンス（503）が文書化されています。
クォータ公開クォータカウンターは月単位です。OpenAPI のクォータレスポンスによると、毎月1日にリセットされます。現在のアカウント状態については、ダッシュボードとクォータのドキュメントを確認してください。
利用範囲トレーニング、コーチング、ハンドレビュー、学習、および研究のみ。実際の金銭を伴うリアルタイム支援 (RTA) は禁止です。

最小限のリクエストとマスク済みのエラーレスポンス

これは意図的に認証情報を省略しています。キーやリクエストヘッダーを公開せずに、公開認証の境界を示しています。

curl -i -s https://pokerai.bet/v1/gto/preflop \
  -H "Content-Type: application/json" \
  -d '{"hole_cards":"AhKh","positions":{"hero":"UTG"},"preflop_actions":[{"position":"SB","action":"small blind","amount":0.5},{"position":"BB","action":"big blind","amount":1}]}'

OpenAPI の Error 例では、キーがない場合にこのマスク済みレスポンス形式がサポートされています：

HTTP 401
{ "error": "missing_api_key" }

エラーの診断中は、API キー、Authorization ヘッダー、またはマスキングされていない顧客リクエスト本文を決してログに記録しないでください。

安全な再試行とバックオフの原則

現在の操作仕様に照らしてレスポンスを分類してからのみ再試行してください。該当する一時的な502または再試行可能な503には、アプリケーション側で管理する、ジッター付きの上限を設けた指数バックオフを使用します。status: busyを伴うソルバーのスケジューリング429は容量状態として扱い、クォータ枯渇とみなさずに後で再試行してください。

現在の公開契約を超えて、試行回数、遅延、SLA、冪等性の挙動、またはエラーコードの意味を約束したりハードコードしたりしないでください。クォータを消費したりワークフローの状態を変更したりする可能性があるリクエストを再送する前に、繰り返しても安全かどうかを自身のアプリケーションで判断してください。

再試行しない場合

変更されていない該当の 400 は再試行しないでください。ペイロードを現在のリクエストスキーマと比較し、無効または不足している入力を修正してください。対応している API キーヘッダーまたはキーを修正するまでは、該当する 401 を再試行しないでください。

すべての 429 を再試行可能として扱わないでください。レスポンスが文書化されたクォータ枯渇を示す場合は、代わりにダッシュボード、プラン、月次リセットの境界を確認してください。status: busy のようなレスポンス形式は、共有エラースキーマではなく、文書化されたソルバーのスケジューリングワークフローに属します。

クォータとソルバーのステータス

Pokerai API は、事前解析済みの検索をリアルタイムの解析とは別に計測します。公開クォータレスポンスでは毎月1日にリセットされる月次カウンターが説明されています。クライアントに上限をハードコードするのではなく、現在のアカウント上限についてはダッシュボードと料金を使用してください。

ソルバーの status、spot_status、node_status は、共有の Error スキーマとは別のワークフローフィールドです。これらの状態を完了時刻や課金の保証として解釈するのではなく、文書化されたソルバー、ツリー、ノードの契約に従ってください。

リアルマネーでのリアルタイム支援 (RTA) は禁止

Pokerai API は、トレーニング、コーチング、ハンドレビュー、学習、研究目的でのみ使用してください。リアルマネーテーブルでのリアルタイム支援は禁止されています。エラー処理と再試行ロジックをライブテーブルでのアドバイスの自動化に使用してはなりません。

文書化されたステータスガイド

これらの説明は、操作の現在のOpenAPIレスポンス一覧で宣言されている場合にのみ適用されます。

HTTP公開契約安全な次の手順
400無効な入力または不足しているフィールド。リクエストスキーマの不一致を修正してください。変更せずに再試行しないでください。
401API キーがないか、無効です。認証を修正してください。同じ欠落または無効な認証情報で再試行しないでください。
429該当する操作での月間クォータの枯渇。ソルバーのスケジューリングでは、代わりに status: busy が報告されることがあります。クォータについては、ダッシュボードとリセット境界を確認してください。文書化された busy については、固定的な再試行の確約をせずに慎重なバックオフを使用してください。
502 / 503該当する操作では、一時的に利用できないバックエンドまたは再試行可能なupstream_unavailableが文書化されています。アプリケーション側で管理する、ジッター付きの上限あり指数バックオフを使用してください。現在の操作契約を再確認してください。

SDK、ドキュメント、リファレンス