Comment obtenir les tirages, outs et bloqueurs au poker avec une API ?
Soumettez un board de main terminée et des cartes privatives aux opérations publiques PokerKit pour obtenir des libellés factuels de tirage, d’out et de bloqueur.
hole et board à POST /v1/pokerkit/draws, POST /v1/pokerkit/outs ou POST /v1/pokerkit/blockers. Il s’agit de contrats OpenAPI publics distincts : consultez le schéma actuel avant d’exploiter result, et n’utilisez les libellés que pour l’entraînement, la révision, l’étude ou la recherche — pas pour sélectionner des actions impliquant de l’argent réel.Faits rapides
| Opérations | POST /v1/pokerkit/draws, /outs et /blockers |
|---|---|
| Entrée requise | hole et board, obligatoires selon le schéma public HandRequest |
| Entrée facultative | hand_type et dead là où le schéma OpenAPI actuel les autorise |
| Limite des résultats | Libellés factuels uniquement ; pas l’équité, un résultat garanti ou un coup recommandé |
| Limite d’utilisation | Formation, coaching, révision, étude et recherche sur des mains terminées uniquement ; aucune RTA en argent réel |
Sémantique des entrées
hole correspond aux deux cartes du Héros et board à un board de trois, quatre ou cinq cartes. Utilisez les codes de cartes standard à deux caractères, sans séparateurs. Le schéma public partagé HandRequest documente également hand_type et dead ; n'inventez pas de formats de cartes ni de champs non pris en charge.
Requête et réponse OpenAPI publiques minimales
Les trois opérations partagent le contrat public HandRequest. Cette requête minimale n’emploie que ses champs obligatoires ; utilisez /outs ou /blockers à la place de /draws pour les autres résultats ciblés, puis examinez le schéma de réponse actuel propre à l’opération.
POST /v1/pokerkit/draws
Authorization: Bearer $POKERAI_API_KEY
Content-Type: application/json
{"hole":"JhTh","board":"AsKsQs"}Interpréter les résultats
Considérez draws comme des étiquettes de tirages documentées, outs comme des catégories et des décomptes documentés de cartes améliorantes, et blockers comme des éléments documentés indiquant le blocage de combinaisons nuts. Un décompte ou une étiquette n'indique ni probabilité, ni éventail de mains adverse, ni équité, ni EV du solveur, ni action recommandée. Considérez les champs comme facultatifs, sauf si le schéma de l'opération actuelle les marque comme obligatoires.
Quand l’utiliser
Utilisez ces opérations pour annoter une main terminée dans un outil d’entraînement, un outil de coaching, une révision d’historique de main, un carnet d’étude ou un flux de travail de recherche. Utilisez Rapport de main lorsqu’une vue d’ensemble factuelle combinée est plus utile qu’une opération ciblée.
Quand ne pas l’utiliser
N’utilisez pas ces libellés pour estimer la probabilité de gagner, promettre un résultat, sélectionner une action en direct ou prendre en charge un format de poker non divulgué. Ne connectez pas la sortie à un flux de table en direct ou à une automatisation.
Quota et erreurs
Ces opérations utilisent la clé API publique et le système de quotas du compte. Consultez la documentation sur les quotas, les tarifs et le tableau de bord pour connaître les limites actuelles ; ne codez pas une limite en dur. Le contrat public déclare les erreurs de validation : corrigez les champs hole, board et facultatifs conformément à l’Référence de l’API actuelle ; en cas d’échec d’authentification ou de quota, suivez la documentation sur les erreurs et n’effectuez pas de nouvelles tentatives avec une requête non valide inchangée.
SDK, MCP et ressources associées
La documentation pour les développeurs couvre la configuration des SDK et de MCP, l’authentification et les quotas. La Référence de l’API et l’instantané OpenAPI sont les contrats publics actuels. Points d’entrée officiels : SDK Python, SDK TypeScript / JavaScript et serveur MCP.
Pas de RTA avec de l’argent réel
Pokerai API est réservée à la formation, au coaching, à l'analyse de mains, à l'étude et à la recherche. L'assistance en temps réel aux tables d'argent réel est interdite. Ne présentez jamais les tirages, outs ou bloqueurs comme une instruction d'action en direct.
Opérations publiques associées
Utilisez le contrat public spécifique qui correspond au libellé factuel dont votre révision de main terminée a besoin.
| Point de terminaison | Tâche | Utilisation |
|---|---|---|
POST /v1/pokerkit/draws | Lire les libellés de tirage | Renvoyer le résultat de tirage documenté pour la main et le board soumis. |
POST /v1/pokerkit/outs | Consulter les outs d’amélioration | Renvoie les catégories d'outs et les décomptes documentés. |
POST /v1/pokerkit/blockers | Lire les éléments de preuve relatifs aux bloqueurs | Renvoyez les champs documentés de bloqueurs de combinaisons nuts. |
Ressources associées
- Documentation développeur — authentification, quotas, SDK, erreurs et sémantique de PokerKit
- Référence de l’API — opérations actuelles de tirages, d'outs et de bloqueurs
- Instantané OpenAPI — contrat anglais lisible par machine
- Guide de l'API d'analyse de mains de poker — flux de travail combiné et factuel de Hand Report
- llms.txt — point d’entrée LLM concis