Comment analyser la texture du board avec PokerKit API ?
Envoyez un board de flop, turn ou river à POST /v1/pokerkit/texture pour recevoir les champs documentés de texture catégorielle et de forme des couleurs pour ce board.
board, telle que AsKsQs, à POST /v1/pokerkit/texture. Lisez le result renvoyé comme des champs décrivant le board, et non comme une équité, une stratégie GTO ou une recommandation d’action en direct.Faits rapides
| Point de terminaison | POST /v1/pokerkit/texture |
|---|---|
| Entrée requise | board : une chaîne sans séparateur comportant 3, 4 ou 5 cartes communes, par exemple AsKsQs |
| Entrée facultative | hand_type et dead, tels que définis dans le schéma OpenAPI public |
| Réponse | Un objet result avec les cartes, les champs catégoriels de texture et les booléens de forme des couleurs |
| Limite d’utilisation | Uniquement pour l’entraînement, le coaching, la révision de mains, l’étude et la recherche ; aucune assistance en temps réel aux tables en argent réel |
Sémantique des entrées
board est requis. Concaténez les codes de cartes standard à deux caractères sans séparateurs : trois cartes décrivent un flop, quatre une turn et cinq une river. Le schéma public autorise aussi hand_type et dead en option ; omettez-les sauf si votre flux de travail documenté les nécessite. N’envoyez pas de cartes privatives à ce point de terminaison : il décrit le board, pas la main d’un joueur.
Requête minimale
Utilisez JSON et une clé API. Ce corps de requête et la réponse ci-dessous constituent l’exemple de code de la documentation publique pokerkitTexture.
curl -s https://pokerai.bet/v1/pokerkit/texture \
-H "Authorization: Bearer $POKERAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"board":"AsKsQs"}'Interprétation de la réponse
{"result":{"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}}cards normalise le board fourni sous forme de tableau. Les champs wetness, connectivity, rank_band, straight_draw et flush_draw sont des descripteurs catégoriels avec name et la value d’affichage. Les trois booléens décrivent la forme des couleurs du board renvoyé. Dans cet exemple, are_monotone est true, tandis que are_two_tone et are_rainbow sont false. Ces libellés décrivent cette entrée ; ils ne calculent pas l’équité et ne sélectionnent pas une action de poker.
Quand l’utiliser
Utilisez Texture lorsqu’un flux de travail d’entraînement, de coaching ou de révision d’une main terminée a besoin d’une description cohérente du board avant de présenter d’autres analyses documentées. Si vous avez besoin d’une vue d’ensemble combinée du board, examinez le contrat public distinct POST /v1/pokerkit/board-report ; si vous avez besoin d’une analyse spécifique au joueur, examinez plutôt les contrats publics hand-report, draws, outs ou blockers.
Quand ne pas l’utiliser
Ne considérez pas un libellé de texture comme une estimation d’équité, un résultat de solveur, une garantie de force de main ou un coup recommandé. Texture ne remplace pas une requête vers un point de terminaison documenté d’équité, GTO ou de main de joueur, et ne doit pas être utilisée pour l’assistance aux décisions en direct à des tables en argent réel.
Quota et erreurs
Ce point de terminaison utilise la même clé API et le même système de quota de compte que l’API publique PokerKit. Consultez la documentation sur les quotas, la tarification et le tableau de bord pour connaître les limites et l’utilisation actuelles du compte, plutôt que de coder en dur une limite dans un client.
| Signal | Signification | À faire |
|---|---|---|
| 422 | Le contrat OpenAPI public déclare une réponse d’erreur de validation. | Vérifiez board et tous les champs facultatifs par rapport à la référence actuelle ou au schéma OpenAPI, puis corrigez la requête. |
| Autres erreurs d’API | La gestion de l’authentification et du quota de compte est documentée au niveau de l’API. | Utilisez la documentation actuelle sur les erreurs et l’état du tableau de bord ; n’effectuez pas de nouvelles tentatives sur une requête invalide inchangée. |
SDK, MCP et ressources associées
- Documentation pour développeurs — configuration officielle des SDK et de MCP, ainsi que de l’authentification et des quotas.
- Référence de l’API — examinez le contrat actuel de requête et de réponse de Texture.
- Instantané OpenAPI — contrat anglais lisible par machine.
- SDK Python, SDK TypeScript / JavaScript et serveur MCP — points d’entrée officiels des packages.
- Guide de l’API de révision de mains de poker — placez la sémantique du board dans un flux de travail après session.
- llms.txt — point d’entrée LLM concis.