Comment analyser et rejouer des historiques de mains PokerKit .phh avec une API ?

Informations rapides

Analyse syntaxique versus relecture

Utilisez parse lorsque votre entrée est une chaîne de texte PokerKit .phh et que vous avez besoin de sa configuration structurée, y compris des champs documentés tels que variant, les blindes, les tapis de départ et actions. Utilisez replay lorsque vous avez besoin d’une vue d’état de l’historique soumis : il peut accepter le text source ou directement les champs de configuration documentés et actions.

Ces points de terminaison ont des rôles différents. Parse ne crée ni chronologie de révision ni recommandation de poker. Replay reconstruit l’état à partir de l’historique fourni ; il ne transforme pas la main en stratégie de solveur, en équité ou en recommandation d’action.

Requête et réponse d’analyse minimales

Utilisez JSON et une clé API. Cette requête et cette réponse constituent l’exemple de code de documentation public 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"]}}

L’exemple de code complet de la documentation publique contient des champs analysés supplémentaires. Considérez la configuration renvoyée comme la représentation structurée de la notation soumise et consultez la Référence actuelle ou l’instantané OpenAPI pour connaître le contrat complet.

Rejouer une main pour l’affichage ou la révision

La relecture peut recevoir une chaîne .phh dans text, ou les champs de configuration documentés et actions. Fournissez index facultatif uniquement lorsque vous avez besoin de l'instantané à un indice d'étape documenté.

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}}

Utilisez les champs snapshot tels que pot, bets, stacks, board et les actions légales pour afficher l’historique soumis. Le step_count de l’exemple correspond au nombre documenté pour cette liste d’actions soumise.

Limite de l’information complète

La relecture est une reconstruction à information complète de ce que vous soumettez. Dans l’exemple de réponse public, snapshot.hole_cards contient les cartes des joueurs soumises. Il ne convient à une interface d’affichage ou de révision que lorsque ces informations font partie du flux de travail de main terminée soumis.

Ne présentez pas la relecture comme une inférence sur les cartes cachées, une simulation à informations partielles, une garantie d'exactitude des résultats ou un outil de décision en direct. Elle reconstruit l'état documenté à partir de la notation ou de la configuration et des actions fournies.

Quand l’utiliser — et quand ne pas l’utiliser

Utilisez ces points de terminaison pour l’importation d’historiques de mains après une session, une chronologie de revue de mains, un affichage de coaching ou d’étude, ou des outils de recherche nécessitant un enregistrement de notation PokerKit structuré et son état reconstruit.

Ne les utilisez pas pour prétendre prendre en charge un autre format d’historique de mains, déduire des informations manquantes sur une main, fournir une assistance en direct sur des tables en argent réel ou transformer des instantanés en instructions de mise. Ils ne remplacent pas un point de terminaison distinct documenté lorsque votre tâche concerne la stratégie GTO, l’équité ou l’évaluation des mains.

Erreurs et contrat actuel

Les deux opérations OpenAPI publiques déclarent une réponse d'erreur de validation 422. Pour l'analyse syntaxique, vérifiez que text est présent et conforme à la notation PokerKit .phh. Pour la relecture, vérifiez text ou les champs de configuration documentés, actions et index facultatif par rapport à la Référence ou au schéma OpenAPI actuels avant de corriger et de soumettre à nouveau.

Utilisez la documentation d’authentification, la documentation des quotas et la documentation des erreurs actuelles pour la gestion au niveau du compte. Ne réessayez pas une requête invalide inchangée.

Pas d’assistance en temps réel avec de l’argent réel

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

Points de terminaison associés

Utilisez le contrat public actuel pour chaque point de terminaison plutôt que de déduire une prise en charge supplémentaire de formats ou d'analyse.

SDK, MCP et ressources associées

• Documentation développeur — configuration du SDK officiel et de MCP, ainsi que l’authentification et les quotas
• Référence API — inspecter les contrats actuels de requête et de réponse d’analyse et de relecture
• Instantané OpenAPI — contrat anglais lisible par machine
• SDK Python — point d’entrée officiel du package
• SDK TypeScript / JavaScript — point d’entrée officiel du package
• Serveur MCP — point d’entrée officiel du package
• Guide de l'API d'examen des mains de poker — placer un historique de main structuré et des instantanés dans un flux de travail post-session
• llms.txt — point d’entrée concis pour les LLM