Pokerai API でポーカーカード文字列を検証・正規化するには？
カードを扱うワークフローで使用する前に、コンパクトなカード文字列を1つ、公開されているPokerKit正規化エンドポイントに送信します。
直接の回答: 必須の
cards 文字列を指定して POST /v1/pokerkit/cards/normalize を呼び出します。公開 CardsRequest の例は AsKsQs です。レスポンスフィールドに依存する前に、最新の リファレンス を参照してください。要点
| 項目 | 公開契約 |
|---|---|
| 操作 | POST /v1/pokerkit/cards/normalize |
| 必須のリクエストボディ | cards、文字列。 |
| 公開例 | AsKsQs。 |
| カード表記 | 各カードは2文字です。ランク AKQJT98765432 の後にスート c、d、h、または s を続けます。区切りなしでカードを連結してください。 |
| 成功時の形式 | HTTP 200 は文書化されていますが、公開 OpenAPI スキーマは未固定です。返された JSON フィールドは固定のフィールドレベル契約ではなく、確認すべきレスポンスデータとして扱ってください。 |
OpenAPI に基づく最小限のリクエスト
curl -s https://pokerai.bet/v1/pokerkit/cards/normalize \
-H "Authorization: Bearer $POKERAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"cards":"AsKsQs"}'このリクエストは公開の CardsRequest 例を使用します。実際に成功した呼び出しは HTTP 200 で JSON を返します。現在の公開スナップショットではそのレスポンススキーマが意図的に未固定のままであるため、実際に返された JSON を確認し、文書化されていないフィールド名をハードコードしないでください。
受け入れられる入力と正規化の範囲
As、Kd、Th のようなコンパクトな2文字カードを使用し、AsKsQs のように1つの文字列として連結してください。このエンドポイントはカード入力を検証・正規化します。エクイティの計算、ハンドの評価、アクションの推奨、戦略の推定は行いません。
一般的なエラーとプライバシー
| シグナル | 公開契約 | 対処方法 |
|---|---|---|
HTTP 422 | HTTPValidationError | cards が存在し JSON 文字列であることを確認してから、送信した表記を現在のリファレンスと照合してください。 |
| 認証 | この操作では Authorization と X-API-Key のリクエストヘッダーが示されています。 | サポートされている API キーヘッダーを1つ送信してください。認証を参照してください。 |
| プライバシー | カードは機密性の高いゲームデータまたはユーザーデータになり得ます。 | 必要なものだけを送信し、API キーをリクエスト本文とログに含めず、プレイヤーまたはハンド履歴を特定できる場合はサポート資料からカード文字列をマスキングしてください。 |
正規化はトレーニング、コーチング、ハンドレビュー、学習、研究のワークフローで使用してください。これはリアルマネーでのリアルタイム支援 (RTA) ではなく、戦略を提供せず、ライブテーブルでのアクションを導くために使用してはなりません。
関連ドキュメント
- ドキュメントハブ — PokerKit と GTO API の概要。
- ポーカーハンド分析ガイド — セッション後の分析ワークフローで正規化済みカード入力を使用します。
- API リファレンス — 現在の操作レベルのリクエストとレスポンスの詳細。
- OpenAPI スナップショット — 公開の
CardsRequestとレスポンス契約。 - Python SDK、TypeScript / JavaScript SDK、MCP サーバー — 公式パッケージのエントリポイント。
Real-time assistance at real-money tables is prohibited.