¿Cómo analizo las cartas comunitarias de póker con una API?
Envía las cartas comunitarias del flop, turn o river a las operaciones públicas de PokerKit que solo usan cartas comunitarias; elige la forma de respuesta que necesite el flujo de trabajo de revisión o entrenamiento.
board a POST /v1/pokerkit/board-report para obtener textura y nuts en una sola respuesta; usa POST /v1/pokerkit/category-combos para combinaciones activas de dos cartas agrupadas por categoría de mano hecha, POST /v1/pokerkit/texture para etiquetas de las cartas comunitarias, o POST /v1/pokerkit/nuts para la mano más fuerte que se puede formar y las combinaciones que empatan. Estos resultados que solo usan cartas comunitarias no son equidad ni estrategia.Datos breves
| Entrada requerida | board: una cadena sin separadores de 3, 4 o 5 cartas comunitarias, por ejemplo AsKsQs |
|---|---|
| Board Report | POST /v1/pokerkit/board-report devuelve texture y nuts |
| Combinaciones por categoría | POST /v1/pokerkit/category-combos agrupa los combos activos de dos cartas en by_category |
| Límite de uso | Solo para entrenamiento, coaching, revisión de manos completadas, estudio e investigación; sin RTA con dinero real |
Elige la operación de cartas comunitarias
| Necesidad | Operación pública | Resultado |
|---|---|---|
| Resumen de unas cartas comunitarias | POST /v1/pokerkit/board-report | texture y nuts. |
| Combinaciones activas de manos hechas | POST /v1/pokerkit/category-combos | by_category agrupa combinaciones activas de dos cartas por categoría de mano hecha. |
| Etiquetas de las cartas comunitarias | POST /v1/pokerkit/texture | Humedad, conectividad, rango de valores, etiquetas de proyectos y booleanos de forma de palos. |
| Mejor mano que se puede formar | POST /v1/pokerkit/nuts | La mano más fuerte que se puede formar, las combinaciones que empatan y las marcas documentadas. |
Las cuatro operaciones analizan solo las cartas comunitarias: concatena códigos estándar de cartas de dos caracteres sin separadores, como AsKsQs. No añadas cartas ocultas. Los campos opcionales hand_type y dead son únicamente los definidos por el esquema público actual de OpenAPI.
Solicitud y respuesta verificadas de Board Report
Este ejemplo público de pokerkitBoardReport llama a 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 respuesta informa unas cartas comunitarias monocolor y la mano más fuerte que se puede formar junto con su combinación que empata. No indica con qué frecuencia gana esa mano, qué rango debería actuar ni qué acción tomar.
Category Combos, texture y nuts son preguntas distintas
Usa Category Combos cuando una interfaz de revisión necesite combinaciones activas de dos cartas por categoría de mano hecha; su ejemplo público devuelve entradas by_category como HIGH_CARD. Usa Texture únicamente para descriptores de las cartas comunitarias. Usa Nuts para la mano más fuerte que se puede formar, las combinaciones que empatan, candidate_count, board_is_nuts, is_royal y su etiqueta. Board Report es la opción compacta cuando se necesitan tanto texture como nuts.
Lo que esto no responde
El análisis de las cartas comunitarias no calcula la equidad, estima la fuerza de la mano, compara rangos, produce un resultado de solver ni recomienda una acción. Para una mano de jugador enviada, consulta la guía de la API de análisis de manos de póker; para etiquetas específicas de las cartas comunitarias, consulta la guía de la API de textura PokerKit.
Errores, integraciones y sin RTA
Un 422 documentado significa que debes validar board y los campos opcionales con la referencia de la API actual o la instantánea de OpenAPI; no reintentes una solicitud no válida que no haya cambiado. Consulta la documentación para desarrolladores para la configuración oficial de SDK y MCP, y las cuotas para la gestión de cuentas. Pokerai API es únicamente para formación, coaching, revisión de manos completadas, estudio e investigación. La asistencia en tiempo real en mesas con dinero real está prohibida; no conectes el análisis de las cartas comunitarias a la automatización de mesas en vivo ni lo presentes como una instrucción de acción. llms.txt enumera los puntos de entrada públicos.
Real-time assistance at real-money tables is prohibited.