← すべてのガイド
このページの内容
  1. ホーム
  2. ガイド
  3. API でポーカーハンドを解析するには？
ガイド ポーカーの意味論 · 04/09 ハンドレビュー 12 分 中級

API でポーカーハンドを解析するには？

ホールカードのハンドとフロップ、ターン、またはリバーのボードをPOST /v1/pokerkit/hand-reportに送信して、文書化された事実に基づくハンドレポートを取得します。

更新 管理者 Pokerai API

直接の回答: ヒーローの統合レポートには、hole と board を POST /v1/pokerkit/hand-report に送信します。ボードのみのタスクでは、board を指定して POST /v1/pokerkit/board-report または POST /v1/pokerkit/category-combos を使用します。hole と board を指定して POST /v1/pokerkit/hand-tier、POST /v1/pokerkit/draws、POST /v1/pokerkit/outs、または POST /v1/pokerkit/blockers を使用します。hole_range を指定して POST /v1/pokerkit/hand-strength を使用します。ボードで作成可能な最強のハンドと同点となるコンボには POST /v1/pokerkit/nuts を使用します。カード文字列の検証と正規化には、cards を指定して POST /v1/pokerkit/cards/normalize を使用します。各操作の result を解釈する前に、現在の OpenAPI スキーマを確認してください。トレーニングまたはレビューには完了済みのハンドを使用し、リアルマネーテーブルでのアクション選択には使用しないでください。

要点

エンドポイントPOST /v1/pokerkit/hand-report
必須入力公開 HandRequest スキーマで定義される hole（2枚のカード）と board（3、4、または5枚のコミュニティカード）
任意の入力公開 OpenAPI スキーマで定義される hand_type と dead
文書化されたレポート提出されたハンドとボードのテクスチャ、メイドハンドのティア、ドロー、アウト、ブロッカーのコンテキスト
利用範囲トレーニング、コーチング、完了済みハンドのレビュー、学習、研究のみ。リアルマネーのリアルタイム支援 (RTA) には使用できません

入力の意味

hole はプレイヤーの2枚のホールカードであり、board は3枚、4枚、または5枚のコミュニティボードです。標準の2文字のカードコードを区切りなしで連結してください。公開されている HandRequest スキーマでは hand_type と dead も使用できますが、文書化されたワークフローで必要な場合を除き省略してください。

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

このcurlリクエストとレスポンスは、共有の公開pokerkitHandReport例です。

curl -s https://pokerai.bet/v1/pokerkit/hand-report \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hole":"JhTh","board":"AsKsQs"}'

{"result":{"texture":{"cards":["As","Ks","Qs"],"wetness":{"name":"WET","value":"Wet"},"connectivity":{"name":"HIGH","value":"High"},"rank_band":{"name":"HIGH","value":"High"},"straight_draw":{"name":"OPEN_ENDED","value":"Open-ended"},"flush_draw":{"name":"LIVE","value":"Live"},"are_two_tone":false,"are_monotone":true,"are_rainbow":false},"tier":{"category":{"name":"STRAIGHT","value":"Straight"},"is_nut":false,"nut_rank":{"name":"NON_NUT","value":"Non-nut"}},"draws":{"straight_draw":null,"flush_draw":null,"nut_rank":null},"outs":{"by_category":{},"count":0}}}

レポートの読み方

texture は、提供されたボードのカード、カテゴリ別のウェットネス、コネクティビティ、ランク帯、利用可能なストレートおよびフラッシュドロー、スート形状のブール値を説明します。tier は完成ハンドを分類します。例では、category はストレート、is_nut は false です。draws は残りのストレートまたはフラッシュドローのラベルとそのナッツランクを記録します。ここでの null は、この例がどちらのドローも報告していないことを意味します。outs は改善となるカードをカテゴリ別にグループ化し、count を提供します。この例には空のグループがあり、アウトはゼロです。

公開ドキュメントでは、Hand Report をテクスチャ、ティア、ドロー、アウト、ブロッカーに関するヒーローの統合概要として説明しています。上記の共通公開レスポンス例には blockers メンバーが含まれていないため、クライアントはそれを必須としてはなりません。文書化されたブロッカーフィールドを確認するには、別個の POST /v1/pokerkit/blockers 契約を使用してください。これはナッツコンボの合計とブロック数、ブロッカーカード、ブロック割合、およびヒーローがナッツをブロックしているかどうかを報告します。

使用する場面

Hand Report を使用して、トレーナー、コーチングツール、ハンド履歴レビュー、学習ノート、または調査ワークフローで完了したハンドに注釈を付けます。UI が、別途文書化された他の解析を提示する前に事実に基づくボードとハンドのラベルを必要とする場合に役立ちます。

使用すべきでない場合

説明用フィールドをエクイティ、ソルバーの解析結果、保証、または推奨アクションとして扱わないでください。このエンドポイントをライブテーブルのフィードに接続したり、その出力に基づくアクションを自動化したり、リアルマネーでのリアルタイム支援に使用したりしないでください。

クォータとエラー

Hand Reportは、公開PokerKit APIと同じAPIキーおよびアカウントクォータシステムを使用します。上限をハードコーディングするのではなく、現在のアカウント上限と使用量についてクォータのドキュメント、料金、ダッシュボードを確認してください。公開OpenAPI契約では422バリデーションレスポンスが宣言されています。現在のAPIリファレンスまたはOpenAPIスキーマに照らして、hole、board、および任意フィールドを修正してください。認証およびクォータのエラーについては、現在のエラーのドキュメントを使用し、変更されていない無効なリクエストを再試行しないでください。

SDK、MCP、関連リソース

開発者向けドキュメントでは、認証とクォータに加え、公式SDKおよびMCPのセットアップを提供しています。APIリファレンスで現在の操作を確認し、機械可読なOpenAPIスナップショットもご覧ください。公式のエントリポイントは、Python SDK、TypeScript / JavaScript SDK、およびMCPサーバーです。

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

Pokerai API は、トレーニング、コーチング、ハンドレビュー、学習、研究のみを目的としています。リアルマネーテーブルでのリアルタイム支援は禁止されています。ハンド解析の出力をライブテーブルの自動化に使用せず、ライブアクションの指示として提示しないでください。

関連する公開操作

レビューでより限定的な事実に基づく結果が必要な場合は、これらの個別の公開コントラクトを使用します。

エンドポイントタスク用途
POST /v1/pokerkit/hand-report1つのハンドとボードを解析する文書化された統合ハンドレポートを返します。
POST /v1/pokerkit/blockersブロッカーの根拠を確認文書化されているナッツコンボのブロッカーフィールドを個別に読み取ります。

関連リソース