← すべてのガイド
このページの内容
  1. ホーム
  2. ガイド
  3. API を使用して PokerKit の .phh ハンド履歴を解析・再生するにはどうすればよいですか？
ガイド ポーカーの意味論 · 07/09 ハンドレビュー 15 分 上級

API を使用して PokerKit の .phh ハンド履歴を解析・再生するにはどうすればよいですか？

POST /v1/pokerkit/notation/parse を使用して、1つのPokerKit .phh 文字列を構造化設定に変換し、次に POST /v1/pokerkit/notation/replay を使用して、ドキュメント化されたアクションステップをレビュー用スナップショットとして再構築します。

更新日 維持管理者 Pokerai API

直接の回答: POST /v1/pokerkit/notation/parse は、PokerKit .phh ハンド履歴文字列を含む必須の text フィールドを受け付けます。POST /v1/pokerkit/notation/replay は、その text または文書化された設定に actions を加えたものを受け付け、1 ステップ用の任意の index を指定できます。解析は構造化されたハンドデータを抽出し、リプレイは表示およびセッション後のレビュー用の状態スナップショットを返します。既知のカードによるセッション後の結果については、POST /v1/pokerkit/eval/hand が指定されたホールディングと任意のボードを評価し、POST /v1/pokerkit/eval/compare が指定された 2 つ以上のホールディングと任意のボードをランク付けします。どちらもハンド履歴を評価せず、不足情報を復元せず、戦略や実戦プレイのアクションを返しません。

早見表

パースエンドポイントPOST /v1/pokerkit/notation/parse
再生エンドポイントPOST /v1/pokerkit/notation/replay
文書化済みの入力パースには text が必要です。リプレイは text、または actions を含む文書化済みの設定フィールドを受け付けます。index は任意です。
文書化された再生出力公開例では result.snapshot と result.step_count が返されます。
利用範囲トレーニング、コーチング、ハンドレビュー、学習、研究目的に限ります。リアルマネーのリアルタイム支援 (RTA) には使用できません。

パースとリプレイの比較

入力が PokerKit の .phh テキスト文字列で、variant、ブラインド、開始スタック、actions などの文書化されたフィールドを含む構造化設定が必要な場合は、パースを使用します。送信した履歴の状態ビューが必要な場合はリプレイを使用します。これはソースの text、または文書化された設定フィールドと actions を直接受け入れます。

これらのエンドポイントには異なる役割があります。パースはレビューのタイムラインやポーカーの推奨を作成しません。リプレイは提供された履歴から状態を再構築しますが、そのハンドをソルバーの戦略、エクイティ、またはアクションの推奨に変換するものではありません。

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

JSON と API キーを使用します。このリクエストとレスポンスは、公開されている pokerkitNotationParse のドキュメントコード例です。

curl -s https://pokerai.bet/v1/pokerkit/notation/parse \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"variant = \"NT\"\nactions = [\"d dh p1 AhKh\", \"d dh p2 QsQd\"]\n"}'
{"result":{"variant":"NT","actions":["d dh p1 AhKh","d dh p2 QsQd"]}}

完全な公開ドキュメントコード例には追加の解析済みフィールドが含まれます。返された設定は送信された表記法の構造化表現として扱い、完全な契約については最新のリファレンスまたは OpenAPIスナップショットを確認してください。

表示またはレビューのためにハンドをリプレイ

リプレイは、text 内の .phh 文字列、または文書化された設定フィールドと actions を受け取れます。文書化された特定のステップインデックスのスナップショットが必要な場合にのみ、任意の index を指定してください。

curl -s https://pokerai.bet/v1/pokerkit/notation/replay \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"variant":"NT","antes":[0,0],"blinds_or_straddles":[1,2],"min_bet":2,"starting_stacks":[200,200],"actions":["d dh p1 AhKh","d dh p2 QsQd","p2 cbr 6","p1 f"],"index":2}'
{"result":{"snapshot":{"terminal":false,"street_index":0,"pot":3,"bets":[2,1],"stacks":[198,199],"board":[],"hole_cards":[{"player":0,"cards":["Ah","Kh"]},{"player":1,"cards":["Qs","Qd"]}]},"step_count":5}}

pot、bets、stacks、board、許可されるアクションなどの snapshot フィールドを使用して、送信された履歴を表示します。例の step_count は、その送信されたアクションリストについて文書化された件数です。

完全情報の境界

リプレイは、送信内容を完全な情報で再構成したものです。公開レスポンス例では、snapshot.hole_cards に送信されたプレイヤーのカードが含まれます。この情報が送信済みの完了ハンドのワークフローに含まれるべき場合に限り、表示またはレビュー用 UI に適しています。

リプレイを、伏せられたカードの推論、部分情報シミュレーション、結果の正確性の保証、またはライブの意思決定ツールとして提示しないでください。提供された表記、または設定とアクションから、文書化された状態を再構築します。

使用する場合と使用しない場合

セッション後のハンド履歴のインポート、ハンドレビューのタイムライン、コーチングまたは学習用の表示、あるいは構造化された PokerKit 表記レコードとその再構築された状態を必要とする研究ツールには、これらのエンドポイントを使用します。

別のハンド履歴形式のサポートを主張するため、欠落したハンド情報を推測するため、ライブのリアルマネー支援を提供するため、またはスナップショットをベッティング指示に変えるために使用しないでください。タスクがGTO戦略、エクイティ、またはハンド評価である場合、これらは別途文書化されたエンドポイントの代替にはなりません。

エラーと現在の契約

両方の公開 OpenAPI 操作では、422 のバリデーションエラーレスポンスが宣言されています。パースでは、text が存在し、PokerKit の .phh 表記に準拠していることを確認してください。リプレイでは、修正して再送信する前に、text または文書化された設定フィールド、actions、任意の index を現在のリファレンスまたは OpenAPI スキーマと照合してください。

アカウントレベルの対応については、現在の 認証ドキュメント、クォータドキュメント、エラードキュメント を使用してください。変更していない無効なリクエストは再試行しないでください。

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

Pokerai API はトレーニング、コーチング、ハンドレビュー、学習、研究専用です。リアルマネーテーブルでのリアルタイム支援は禁止されています。パースおよびリプレイの出力をライブテーブルの自動化から除外し、スナップショットをライブアクションの指示として提示しないでください。

関連エンドポイント

追加の形式や解析サポートを推測するのではなく、各エンドポイントについて現在の公開契約を使用してください。

エンドポイント機能使用目的
POST /v1/pokerkit/notation/parsePokerKit の .phh 表記を含む必須の text を構造化されたハンドデータにパースする文書化された PokerKit ハンド履歴のインポート
POST /v1/pokerkit/notation/replay送信された text または設定と actions をスナップショットに再構築します。省略可能な index で1つのステップを選択します送信された完了ハンドを表示またはレビューする

SDK、MCP、および関連リソース