Comment analyser un board de poker avec une API ?
Envoyez un board au flop, à la turn ou à la river aux opérations publiques de PokerKit dédiées uniquement au board ; choisissez la forme de réponse requise par le flux de travail de révision ou d’entraînement.
board à POST /v1/pokerkit/board-report pour obtenir la texture et les nuts dans une seule réponse ; utilisez POST /v1/pokerkit/category-combos pour les combinaisons actives de deux cartes regroupées par catégorie de main faite, POST /v1/pokerkit/texture pour les libellés du board, ou POST /v1/pokerkit/nuts pour la meilleure main réalisable et les combinaisons à égalité. Ces résultats portant uniquement sur le board ne concernent ni l’équité ni la stratégie.Informations clés
| Entrée requise | board : une chaîne sans séparateur de 3, 4 ou 5 cartes communes, par exemple AsKsQs |
|---|---|
| Board Report | POST /v1/pokerkit/board-report renvoie texture et nuts |
| Combinaisons par catégorie | POST /v1/pokerkit/category-combos regroupe les combinaisons actives de deux cartes dans by_category |
| Limite d’utilisation | Uniquement pour l’entraînement, le coaching, la révision de mains terminées, l’étude et la recherche ; pas de RTA à argent réel |
Choisir l’opération sur le board
| Besoin | Opération publique | Résultat |
|---|---|---|
| Vue d’ensemble d’un board | POST /v1/pokerkit/board-report | texture et nuts. |
| Combinaisons actives de mains faites | POST /v1/pokerkit/category-combos | by_category regroupe les combinaisons actives de deux cartes par catégorie de main faite. |
| Libellés du board | POST /v1/pokerkit/texture | Humidité, connectivité, plage de rangs, libellés de tirages et booléens de répartition des couleurs. |
| Meilleure main réalisable | POST /v1/pokerkit/nuts | Meilleure main réalisable, combinaisons à égalité et indicateurs documentés. |
Les quatre opérations portent uniquement sur le board : concaténez les codes de cartes standard à deux caractères sans séparateurs, par exemple AsKsQs. N’ajoutez pas les cartes privatives. Les champs facultatifs hand_type et dead sont uniquement ceux définis par le schéma OpenAPI public actuel.
Requête et réponse Board Report vérifiées
Cet exemple public pokerkitBoardReport appelle POST /v1/pokerkit/board-report.
{"board":"AsKsQs"}{"result":{"texture":{"cards":["As","Ks","Qs"],"wetness":{"name":"WET","value":"Wet"},"are_monotone":true},"nuts":{"hand":"TsJsKsQsAs","combos":[{"cards":["Ts","Js"]}],"candidate_count":1176,"board_is_nuts":false,"is_royal":true,"label":{"name":"STRAIGHT_FLUSH","value":"Straight flush"}}}}La réponse indique un board monochrome et la meilleure main réalisable ainsi que sa combinaison à égalité. Elle ne dit pas à quelle fréquence cette main gagne, quelle range doit agir, ni quelle action entreprendre.
Category Combos, Texture et Nuts répondent à des questions différentes
Utilisez Category Combos lorsqu’une interface de révision a besoin de combinaisons actives de deux cartes par catégorie de main faite ; son exemple public renvoie des entrées by_category telles que HIGH_CARD. Utilisez Texture uniquement pour les descripteurs du board. Utilisez Nuts pour la meilleure main réalisable, les combinaisons à égalité, candidate_count, board_is_nuts, is_royal et son libellé. Board Report est le choix compact lorsque la texture et les nuts sont tous deux nécessaires.
Ce que cela ne permet pas de savoir
L’analyse du board ne calcule pas l’équité, n’estime pas la force de la main, ne compare pas les ranges, ne produit pas de résultat de solveur et ne recommande pas d’action. Pour une main de joueur soumise, consultez le guide de l’API d’analyse de main de poker ; pour des libellés ciblés du board, consultez le guide de l’API de texture PokerKit.
Erreurs, intégrations et absence de RTA
Un 422 documenté signifie qu’il faut valider board et les champs facultatifs par rapport à l’Référence de l’API actuelle ou à l’instantané OpenAPI ; n’effectuez pas de nouvelles tentatives pour une requête invalide inchangée. Consultez la documentation développeur pour la configuration officielle des SDK et de MCP, ainsi que les quotas pour la gestion des comptes. Pokerai API est réservé à l’entraînement, au coaching, à la révision de mains terminées, à l’étude et à la recherche. L’assistance en temps réel aux tables en argent réel est interdite ; ne connectez pas l’analyse du board à une automatisation de table en direct et ne la présentez pas comme une instruction d’action. llms.txt répertorie les points d’entrée publics.
Real-time assistance at real-money tables is prohibited.