¿Cómo analizo la textura de las cartas comunitarias con la API de PokerKit?
Envía las cartas comunitarias del flop, turn o river a POST /v1/pokerkit/texture para recibir los campos documentados de textura categórica y forma de palos de esas cartas comunitarias.
board, como AsKsQs, a POST /v1/pokerkit/texture. Interpreta el result devuelto como campos de descripción de las cartas comunitarias, no como equity, una estrategia GTO ni una recomendación de acción en vivo.Datos rápidos
| Punto de conexión | POST /v1/pokerkit/texture |
|---|---|
| Entrada obligatoria | board: una cadena sin separadores con 3, 4 o 5 cartas comunitarias, por ejemplo AsKsQs |
| Entrada opcional | hand_type y dead, tal como se definen en el esquema público de OpenAPI |
| Respuesta | Un objeto result con cartas, campos de textura categórica y valores booleanos de forma de palos |
| Límite de uso | Solo para formación, coaching, revisión de manos, estudio e investigación; sin RTA con dinero real |
Semántica de entrada
board es obligatorio. Concatena códigos de cartas estándar de dos caracteres sin separadores: tres cartas describen un flop, cuatro un turn y cinco un river. El esquema público también permite hand_type y dead opcionales; omítelos salvo que tu flujo de trabajo documentado los necesite. No envíes cartas ocultas a este endpoint: describe la mesa, no la mano de un jugador.
Solicitud mínima
Usa JSON y una clave de API. Este cuerpo de solicitud y la respuesta siguiente constituyen el ejemplo público de código de documentación de pokerkitTexture.
curl -s https://pokerai.bet/v1/pokerkit/texture \
-H "Authorization: Bearer $POKERAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"board":"AsKsQs"}'Interpretación de la respuesta
{"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 normaliza la mesa proporcionada en un array. Los campos wetness, connectivity, rank_band, straight_draw y flush_draw son descriptores categóricos con name y el value mostrado. Los tres valores booleanos describen la configuración de palos de la mesa devuelta. En este ejemplo, are_monotone es verdadero, mientras que are_two_tone y are_rainbow son falsos. Estas etiquetas describen esta entrada; no calculan la equidad ni seleccionan una acción de póker.
Cuándo usarlo
Usa Texture cuando un flujo de trabajo de entrenamiento, coaching o revisión de manos completadas necesite una descripción coherente de la mesa antes de presentar otros análisis documentados. Si necesitas una vista general combinada de la mesa, consulta el contrato público independiente de POST /v1/pokerkit/board-report; si necesitas análisis específico de un jugador, consulta en su lugar los contratos públicos de informe de mano, proyectos, outs o bloqueadores.
Cuándo no usarlo
No trates una etiqueta de textura como una estimación de equidad, un resultado de solver, una garantía de fuerza de mano ni una jugada recomendada. Texture no sustituye una solicitud a un endpoint documentado de equidad, GTO o mano de jugador, y no debe utilizarse para asistencia de decisiones en vivo con dinero real.
Cuotas y errores
Este endpoint usa la misma clave de API y el mismo sistema de cuotas de cuenta que la API pública de PokerKit. Consulta la documentación sobre cuotas, los precios y el panel para conocer los límites y el uso actuales de la cuenta, en lugar de codificar un límite de forma fija en un cliente.
| Señal | Significado | Qué hacer |
|---|---|---|
| 422 | El contrato público de OpenAPI declara una respuesta de error de validación. | Comprueba board y cualquier campo opcional con la referencia actual o el esquema de OpenAPI y, a continuación, corrige la solicitud. |
| Otros errores de API | La gestión de autenticación y cuotas de cuenta está documentada a nivel de API. | Usa la documentación de errores actual y el estado del panel; no reintentes una solicitud inválida sin cambios. |
SDK, MCP y recursos relacionados
- Documentación para desarrolladores — configuración oficial de SDK y MCP junto con autenticación y cuotas.
- Referencia de la API — consulta el contrato actual de solicitud y respuesta de Texture.
- Instantánea de OpenAPI — contrato en inglés legible por máquinas.
- SDK de Python, SDK de TypeScript / JavaScript y servidor MCP — puntos de entrada oficiales de los paquetes.
- Guía de API de revisión de manos de póker — sitúa la semántica de la mesa en un flujo de trabajo posterior a la sesión.
- llms.txt — punto de entrada conciso para LLM.