← Todas las guías
En esta página
  1. Inicio
  2. Guías
  3. ¿Cómo analizo una mano de póker con una API?
Guía Semántica del póker · 04/09 Revisión de manos 12 min Intermedio

¿Cómo analizo una mano de póker con una API?

Envía una mano de cartas ocultas y una mesa de flop, turn o river a POST /v1/pokerkit/hand-report para obtener un informe factual documentado de la mano.

Actualizado Mantenido por Pokerai API

Respuesta directa: para obtener un informe combinado de Hero, envía hole y board a POST /v1/pokerkit/hand-report. Para tareas solo de mesa, usa POST /v1/pokerkit/board-report o POST /v1/pokerkit/category-combos con board; usa POST /v1/pokerkit/hand-tier, POST /v1/pokerkit/draws, POST /v1/pokerkit/outs o POST /v1/pokerkit/blockers con hole y board; usa POST /v1/pokerkit/hand-strength con hole_range; usa POST /v1/pokerkit/nuts para la mano más fuerte que se pueda formar en la mesa y las combinaciones que empatan; y usa POST /v1/pokerkit/cards/normalize con cards para validar y normalizar cadenas de cartas. Consulta el esquema OpenAPI actual de cada operación antes de interpretar su result; usa manos completadas para entrenamiento o revisión, no para seleccionar acciones en una mesa con dinero real.

Datos rápidos

Punto de conexiónPOST /v1/pokerkit/hand-report
Entrada obligatoriahole (dos cartas) y board (3, 4 o 5 cartas comunitarias), tal como se definen en el esquema público HandRequest
Entrada opcionalhand_type y dead, tal como se definen en el esquema público de OpenAPI
Informe documentadoTextura, nivel de mano hecha, proyectos, outs y contexto de bloqueadores para la mano y la mesa enviadas
Límite de usoSolo para entrenamiento, coaching, revisión de manos completadas, estudio e investigación; sin RTA con dinero real

Semántica de entrada

hole son las dos cartas privadas del jugador y board es una mesa comunitaria de tres, cuatro o cinco cartas. Concatena códigos de cartas estándar de dos caracteres sin separadores. El esquema público HandRequest también permite hand_type y dead; omítelos salvo que un flujo de trabajo documentado los requiera.

Solicitud y respuesta mínimas

Esta solicitud y respuesta de curl son el ejemplo público compartido de pokerkitHandReport.

curl -s https://pokerai.bet/v1/pokerkit/hand-report \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hole":"JhTh","board":"AsKsQs"}'

{"result":{"texture":{"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},"tier":{"category":{"name":"STRAIGHT","value":"Straight"},"is_nut":false,"nut_rank":{"name":"NON_NUT","value":"Non-nut"}},"draws":{"straight_draw":null,"flush_draw":null,"nut_rank":null},"outs":{"by_category":{},"count":0}}}

Cómo interpretar el informe

texture describe la mesa proporcionada: sus cartas, humedad categórica, conectividad, banda de rangos, proyectos disponibles de escalera y color, y booleanos de forma de palos. tier clasifica la mano formada; en el ejemplo, category es Escalera y is_nut es false. draws registra las etiquetas de proyectos restantes de escalera o color y su rango nut; null aquí significa que el ejemplo no informa ninguno de los dos proyectos. outs agrupa las cartas de mejora por categoría y proporciona count; este ejemplo tiene un grupo vacío y cero outs.

La documentación pública describe Hand Report como la vista general combinada de Hero para la textura, el nivel, los proyectos, las outs y los bloqueadores. El ejemplo de respuesta pública compartida anterior no incluye un miembro blockers, por lo que los clientes no deben exigirlo. Para inspeccionar los campos de bloqueadores documentados, use el contrato independiente POST /v1/pokerkit/blockers: informa los totales de combinaciones de nuts y los recuentos bloqueados, las cartas bloqueadoras, una fracción de bloqueo y si Hero bloquea las nuts.

Cuándo usarlo

Usa Hand Report para anotar una mano completada en un entrenador, una herramienta de coaching, una revisión del historial de manos, un cuaderno de estudio o un flujo de trabajo de investigación. Es útil cuando la interfaz necesita etiquetas factuales del tablero y la mano antes de presentar otros análisis documentados por separado.

Cuándo no usarlo

No trates los campos descriptivos como equity, un resultado del solver, una garantía o una jugada recomendada. No conectes este endpoint a una fuente de mesa en vivo, automatices una acción a partir de su salida ni lo uses para asistencia en tiempo real con dinero real.

Cuota y errores

Hand Report utiliza la misma clave de API y el mismo sistema de cuota de cuenta que la API pública de PokerKit. Consulte la documentación sobre cuotas, los precios y el panel de control para conocer los límites y el uso actuales de la cuenta, en lugar de codificar un límite de forma rígida. El contrato público de OpenAPI declara una respuesta de validación 422; corrija hole, board y los campos opcionales conforme a la Referencia o al esquema de OpenAPI actuales. Para los errores de autenticación y de cuota, use la documentación de errores vigente y no vuelva a intentar una solicitud inválida sin cambios.

SDK, MCP y recursos relacionados

Documentación para desarrolladores ofrece la configuración oficial de SDK y MCP junto con la autenticación y las cuotas. Consulta la operación actual en la Referencia de la API y la instantánea de OpenAPI legible por máquinas. Los puntos de entrada oficiales son el SDK de Python, el SDK de TypeScript / JavaScript y el servidor MCP.

Sin RTA con dinero real

Pokerai API es solo para entrenamiento, coaching, revisión de manos, estudio e investigación. Se prohíbe la asistencia en tiempo real en mesas con dinero real. Mantenga el resultado del análisis de manos fuera de la automatización de mesas en vivo y no lo presente como una instrucción de acción en vivo.

Operaciones públicas relacionadas

Usa estos contratos públicos independientes cuando una revisión necesite un resultado factual más específico.

Punto de conexiónTareaUso
POST /v1/pokerkit/hand-reportAnalizar una mano y un tableroDevuelve el informe de mano documentado combinado.
POST /v1/pokerkit/blockersInspeccionar la evidencia de bloqueadoresConsulte por separado los campos documentados de bloqueadores de combinaciones nuts.

Recursos relacionados