Comment analyser une main de poker avec une API ?

Envoyez une main de cartes privatives et un board au flop, au turn ou à la river à POST /v1/pokerkit/hand-report pour obtenir un rapport factuel documenté sur la main.

Mis à jour 27 juillet 2026Maintenu par Pokerai API

Réponse directe : pour un rapport combiné du Héros, soumettez hole et board à POST /v1/pokerkit/hand-report. Pour les tâches portant uniquement sur le board, utilisez POST /v1/pokerkit/board-report ou POST /v1/pokerkit/category-combos avec board ; utilisez POST /v1/pokerkit/hand-tier, POST /v1/pokerkit/draws, POST /v1/pokerkit/outs ou POST /v1/pokerkit/blockers avec hole et board ; utilisez POST /v1/pokerkit/hand-strength avec hole_range ; utilisez POST /v1/pokerkit/nuts pour la main réalisable la plus forte du board et les combinaisons à égalité ; et utilisez POST /v1/pokerkit/cards/normalize avec cards pour valider et normaliser les chaînes de cartes. Consultez le schéma OpenAPI actuel de chaque opération avant d’interpréter son result ; utilisez des mains terminées pour la formation ou la révision, et non pour sélectionner une action à une table en argent réel.

En bref

Point de terminaison	`POST /v1/pokerkit/hand-report`
Entrée requise	`hole` (deux cartes) et `board` (3, 4 ou 5 cartes communes), tels que définis par le schéma public `HandRequest`
Entrée facultative	`hand_type` et `dead`, tels que définis par le schéma OpenAPI public
Rapport documenté	Texture, niveau de main faite, tirages, outs et contexte des bloqueurs pour la main et le board soumis
Limite d’utilisation	Réservé à la formation, au coaching, à l’examen de mains terminées, à l’étude et à la recherche ; aucune assistance en temps réel aux tables en argent réel

Sémantique des entrées

hole correspond aux deux cartes fermées du joueur et board à un board communautaire de trois, quatre ou cinq cartes. Concaténez les codes de cartes standard à deux caractères sans séparateurs. Le schéma public HandRequest autorise également hand_type et dead ; omettez-les sauf si un flux de travail documenté les exige.

Requête et réponse minimales

Cette requête et cette réponse curl constituent l’exemple public partagé de 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}}}

Comment interpréter le rapport

texture décrit le board fourni : ses cartes, son degré d'humidité catégoriel, sa connectivité, sa tranche de rangs, les tirages de quinte et de couleur disponibles, et des booléens sur la forme des couleurs. tier classe la main faite ; dans l'exemple, category est Straight et is_nut est false. draws enregistre les libellés des tirages restants de quinte ou de couleur et leur rang nut ; null signifie ici que l'exemple ne signale aucun des deux tirages. outs regroupe les cartes d'amélioration par catégorie et fournit count ; cet exemple comporte un groupe vide et zéro out.

La documentation publique décrit Hand Report comme la vue d’ensemble combinée du Héros pour la texture, le niveau, les tirages, les outs et les bloqueurs. L’exemple de réponse publique partagé ci-dessus ne contient pas de membre blockers ; les clients ne doivent donc pas en exiger un. Pour examiner les champs de bloqueurs documentés, utilisez le contrat distinct POST /v1/pokerkit/blockers : il indique les totaux de combinaisons maximales et les décomptes bloqués, les cartes bloqueuses, une fraction de blocage et si le Héros bloque les nuts.

Quand l’utiliser

Utilisez Hand Report pour annoter une main terminée dans un outil d’entraînement, de coaching, de révision de l’historique des mains, un carnet d’étude ou un flux de recherche. Il est utile lorsque l’interface a besoin de libellés factuels pour le board et la main avant de présenter d’autres analyses documentées séparément.

Quand ne pas l'utiliser

Ne considérez pas les champs descriptifs comme de l'équité, un résultat de solveur, une garantie ou un coup recommandé. Ne connectez pas cet endpoint à un flux de table en direct, n'automatisez pas une action à partir de sa sortie et ne l'utilisez pas pour une assistance en temps réel avec de l'argent réel.

Quotas et erreurs

Hand Report utilise la même clé API et le même système de quotas de compte que l’API publique PokerKit. Consultez la documentation sur les quotas, les tarifs et le tableau de bord pour connaître les limites et l’utilisation actuelles du compte plutôt que de coder une limite en dur. Le contrat OpenAPI public déclare une réponse de validation 422 ; corrigez hole, board et les champs facultatifs par rapport à la Référence de l’API actuelle ou au schéma OpenAPI. Pour les erreurs d’authentification et de quota, utilisez la documentation actuelle sur les erreurs et n’effectuez pas de nouvelles tentatives pour une requête invalide inchangée.

SDK, MCP et ressources associées

La documentation pour les développeurs fournit la configuration officielle des SDK et de MCP, ainsi que l'authentification et les quotas. Consultez l'opération actuelle dans la Référence de l'API et l'instantané OpenAPI lisible par machine. Les points d'entrée officiels sont le SDK Python, le SDK TypeScript / JavaScript et le serveur MCP.

Aucune RTA avec de l'argent réel

Pokerai API est destinée uniquement à l’entraînement, au coaching, à la revue de mains, à l’étude et à la recherche. L’assistance en temps réel aux tables jouées en argent réel est interdite. N’intégrez pas les résultats d’analyse de mains dans l’automatisation de tables en direct et ne les présentez pas comme une instruction d’action en direct.

Opérations publiques associées

Utilisez ces contrats publics distincts lorsqu’une révision nécessite un résultat factuel plus ciblé.

Point de terminaison	Tâche	Utilisation
`POST /v1/pokerkit/hand-report`	Analyser une main et un board	Renvoie le rapport documenté combiné sur la main.
`POST /v1/pokerkit/blockers`	Examiner les informations sur les bloqueurs	Lisez séparément les champs documentés des bloqueurs de combinaisons maximales.

Ressources associées

Documentation développeur — authentification, quotas, SDK, erreurs et sémantique de PokerKit
Référence de l’API — opération Hand Report actuelle et schémas publics
Instantané OpenAPI — contrat anglais lisible par machine
Guide de l’API de revue de mains de poker — un flux de travail de révision après session
llms.txt — point d’entrée LLM concis