ドキュメントトピック · エラー処理

Pokerai API のエラーをトラブルシューティングするには？

まず操作の公開 HTTP レスポンスとスキーマを使用してください。ソルバーの進行状況ステータスは、共通のエラーボディとは別です。

更新 2026-07-26

直接の回答: HTTPステータスと、そのエンドポイントの最新のリファレンスまたはOpenAPIスナップショットを照合してください。共通の公開Errorスキーマにはerrorがあり、messageが含まれる場合があります。ソルバーのstatus、spot_status、node_statusは別個のレスポンスフィールドです。

クイック情報

事項	公開仕様
エラー本文	共通の `Error` スキーマは `error` と `message` を規定しています。いずれかのフィールドに未公開の形式がある、またはすべての操作が同一のフィールドを返すとは想定しないでください。
認証	`401` は、`Unauthorized` を宣言する操作において API キーが欠落しているか無効であることを意味します。
バリデーション	`400` は、該当する GTO 操作で無効な入力または必須フィールドの欠落に対して規定されています。その操作の現在のリクエストスキーマを確認してください。
クォータと容量	`429` は、該当する操作で月間クォータが枯渇した場合に規定されています。ソルバーのスケジューリングでは `{ "status": "busy" }` が返ることもあります。
ソルバーの進行状況	`status`、`spot_status`、`node_status` は、共通の `Error` スキーマではなく、非同期ソルバーワークフローを示します。

最小限の失敗リクエストとレスポンス

curl -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}]}'

HTTP 401
{ "error": "missing_api_key" }

この最小限の失敗形式では、公開されている Error フィールドの例を使用しています。診断中に API キーやリクエストヘッダーをログに記録しないでください。

認証、バリデーション、クォータの境界

HTTP	公開上の意味	次に確認すること
400	無効な入力または必須フィールドの欠落。	JSON 本文を、その操作の現在のリファレンスまたは OpenAPI リクエストスキーマと比較してください。
401	API キーが欠落しているか無効。	サポートされているキーのヘッダーを 1 つ送信してください。認証を参照してください。
404	`NoSolution` を宣言する操作で、そのスポットまたはボードに GTO データがありません。	送信したスポットまたはボードが、その操作で文書化されている対象範囲に合っているか確認してください。
429	月間クォータを超過した、またはソルバーのスケジューリングで全ソルバーホストがビジーの場合の `status: busy`。	クォータについては、クォータとダッシュボードを参照してください。`busy` は容量の状態として扱い、現在のソルバー操作の仕様に従ってください。このページでは再試行タイミングを保証しません。
502 / 503	`502` は、該当する操作でバックエンドが一時的に利用できないことを示します。`503` は、サービス自身の再試行後に `upstream_unavailable` を報告することがあります。	OpenAPI 仕様では、`503` のアップストリームのケースは再試行可能とされています。再試行回数、遅延、SLA を推測しないでください。

ソルバーのステータスはエラーコードではありません

POST /v1/gto/solver の後、スケジューリングにより status の値として computing、queryable、busy が返ることがあります。spot_status が queryable になるまで POST /v1/gto/solver/tree をポーリングしてください。公開されているツリー仕様では、available、computing、expired、no_nodes も規定されています。no_nodes は終端状態なので、ポーリングを停止してください。ノードのレスポンスでは、error を含む node_status の値が別途規定され、そのノード状態では message が存在します。

expired ノードは、解析が回収または置換されたことを意味します。公開仕様では再スケジュールするよう記載されています。ソルバーのステータスを、エンドポイントの現在の公開ドキュメントを超えて、完了時間、容量、料金に関する約束として解釈しないでください。

安全な利用と問い合わせ

Pokerai API はトレーニング、コーチング、ハンドレビュー、学習、研究に使用してください。リアルマネーでのリアルタイム支援 (RTA) は禁止されています。未解決の公開仕様に関する質問については、エンドポイント、HTTP ステータス、伏せ字にしたレスポンス本文を保持してから、公式のお問い合わせチャネルを利用してください。API キーは決して含めないでください。