← すべてのガイド
このページの内容
  1. ホーム
  2. ガイド
  3. API でポーカーのドロー、アウト、ブロッカーを取得するには？
ガイド ポーカーの意味論 · 05/09 ハンドレビュー 10 分 中級

API でポーカーのドロー、アウト、ブロッカーを取得するには？

完成したハンドのボードとホールカードを公開 PokerKit オペレーションに送信し、事実に基づくドロー、アウト、ブロッカーのラベルを取得します。

更新日 管理 Pokerai API

直接の回答: hole と board を POST /v1/pokerkit/draws、POST /v1/pokerkit/outs、または POST /v1/pokerkit/blockers に送信してください。これらは個別の公開 OpenAPI コントラクトです。result を利用する前に現在のスキーマを確認し、ラベルはトレーニング、レビュー、学習、または研究にのみ使用してください。リアルマネーでのアクション選択には使用しないでください。

簡単な要点

操作POST /v1/pokerkit/draws、/outs、/blockers
必須入力公開 HandRequest スキーマで必須の hole と board
任意の入力現在の OpenAPI スキーマで許可されている場合の hand_type と dead
結果の範囲事実に基づくラベルのみ。エクイティ、保証された結果、推奨アクションではありません
利用範囲完了済みハンドのトレーニング、コーチング、レビュー、学習、研究に限る。リアルマネーのリアルタイム支援 (RTA) には使用しない

入力の意味

hole はヒーローの 2 枚のカード、board は 3、4、または 5 枚のカードからなるボードです。区切り文字なしの標準的な 2 文字のカードコードを使用してください。共有の公開 HandRequest スキーマには hand_type と dead も記載されています。サポートされていないカード形式やフィールドを独自に作らないでください。

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

この3つの操作は公開 HandRequest コントラクトを共有します。この最小リクエストでは必須フィールドのみを使用します。ほかの限定的な結果には /draws の代わりに /outs または /blockers を使用し、その後、現在の操作固有のレスポンススキーマを確認してください。

POST /v1/pokerkit/draws
Authorization: Bearer $POKERAI_API_KEY
Content-Type: application/json

{"hole":"JhTh","board":"AsKsQs"}

結果の解釈

draws は文書化されたドローラベル、outs は文書化された改善カードのカテゴリと枚数、blockers は文書化されたナッツコンボのブロッキング根拠として扱います。枚数やラベルは、確率、相手のレンジ、エクイティ、ソルバー EV、推奨アクションを示すものではありません。現在の操作スキーマで必須とされていない限り、フィールドは任意のままにしてください。

使用する場合

これらの操作を使用して、トレーナー、コーチングツール、ハンド履歴レビュー、学習ノート、または研究ワークフローで完了済みのハンドに注釈を付けます。限定的な操作より統合された事実の概要が役立つ場合は、ハンドレポート を使用してください。

使用しない場合

これらのラベルを勝率の推定、結果の保証、ライブでのアクションの選択、または未公開のポーカーフォーマットのサポートに使用しないでください。出力をライブテーブルのフィードや自動化に接続しないでください。

クォータとエラー

これらのオペレーションは公開 API キーとアカウントのクォータシステムを使用します。現在の制限についてはクォータのドキュメント、料金、ダッシュボードを確認してください。制限をハードコードしないでください。公開コントラクトではバリデーションエラーが定義されています。hole、board、および任意フィールドを現在のAPI リファレンスに照らして修正してください。認証またはクォータの失敗については、エラーのドキュメントに従い、変更していない無効なリクエストを再試行しないでください。

SDK、MCP、関連リソース

開発者向けドキュメントでは、SDKとMCPのセットアップ、認証、クォータについて説明しています。APIリファレンスとOpenAPIスナップショットは、現在の公開契約です。公式エントリーポイント: Python SDK、TypeScript / JavaScript SDK、MCPサーバー。

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

Pokerai API はトレーニング、コーチング、ハンドレビュー、学習、研究専用です。リアルマネーテーブルでのリアルタイム支援 (RTA) は禁止されています。ドロー、アウト、ブロッカーをライブアクションの指示として提示してはいけません。

関連する公開操作

完了済みハンドのレビューで必要な事実ラベルに合う限定的な公開コントラクトを使用してください。

エンドポイントタスク用途
POST /v1/pokerkit/drawsドローラベルを取得提出されたハンドとボードについて、文書化されたドロー結果を返します。
POST /v1/pokerkit/outs改善アウトを確認文書化されたアウトのカテゴリと数を返します。
POST /v1/pokerkit/blockersブロッカーの根拠を確認文書化されたナッツコンボのブロッカー項目を返します。

関連リソース