¿Cómo analizo y reproduzco historiales de manos .phh de PokerKit con una API?

Datos rápidos

Análisis frente a repetición

Usa parse cuando la entrada sea una cadena de texto .phh de PokerKit y necesites su configuración estructurada, incluidos campos documentados como variant, las ciegas, los stacks iniciales y actions. Usa replay cuando necesites una vista de estado del historial enviado: puede aceptar el text de origen o los campos de configuración documentados y actions directamente.

Estos endpoints tienen funciones diferentes. Parse no crea una cronología de revisión ni una recomendación de póker. Replay reconstruye el estado a partir del historial proporcionado; no convierte la mano en una estrategia de solver, equidad ni una recomendación de acción.

Solicitud y respuesta mínimas de análisis

Usa JSON y una clave de API. Esta solicitud y respuesta son el ejemplo público de código de documentación de 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"]}}

El ejemplo completo de código de la documentación pública contiene campos analizados adicionales. Trata la configuración devuelta como la representación estructurada de la notación enviada y consulta la Referencia actual o la instantánea de OpenAPI para conocer el contrato completo.

Reproducir una mano para mostrarla o revisarla

Replay puede recibir una cadena .phh en text, o los campos de configuración documentados y actions. Proporciona el index opcional solo cuando necesites la instantánea en un índice de paso documentado.

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

Usa campos de snapshot, como pot, bets, stacks, board y acciones legales, para mostrar el historial enviado. El step_count del ejemplo es el recuento documentado para esa lista de acciones enviada.

Límite de información completa

Replay es una reconstrucción con información completa de lo que envías. En el ejemplo de respuesta pública, snapshot.hole_cards contiene las cartas de los jugadores enviadas. Es apropiado para una interfaz de usuario de visualización o revisión solo cuando esa información pertenece al flujo de trabajo de manos completadas enviadas.

No presentes replay como inferencia de cartas ocultas, simulación con información parcial, garantía de exactitud de los resultados ni herramienta de decisión en vivo. Reconstruye el estado documentado a partir de la notación o configuración y acciones proporcionadas.

Cuándo usarlo y cuándo no

Usa estos endpoints para la importación de historiales de manos posterior a la sesión, una cronología de revisión de manos, una visualización de entrenamiento o estudio, o herramientas de investigación que necesiten un registro de notación PokerKit estructurado y su estado reconstruido.

No los uses para afirmar que se admite otro formato de historial de manos, para inferir información de manos faltante, para proporcionar asistencia en directo con dinero real ni para convertir instantáneas en instrucciones de apuestas. No sustituyen a un endpoint documentado por separado cuando tu tarea es estrategia GTO, equidad o evaluación de manos.

Errores y contrato actual

Ambas operaciones públicas de OpenAPI declaran una respuesta de error de validación 422. Para parse, comprueba que text esté presente y se ajuste a la notación .phh de PokerKit. Para replay, comprueba text o los campos de configuración documentados, actions y el index opcional con la Referencia o el esquema OpenAPI actuales antes de corregir y volver a enviar.

Use la documentación de autenticación, la documentación sobre cuotas y la documentación sobre errores actuales para la gestión a nivel de cuenta. No vuelva a intentar una solicitud no válida sin cambios.

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. Mantén los resultados de análisis y reproducción fuera de la automatización de mesas en directo y no presentes una instantánea como una instrucción de acción en directo.

Endpoints relacionados

Utiliza el contrato público actual de cada endpoint en lugar de inferir compatibilidad adicional con formatos o análisis.

SDK, MCP y recursos relacionados

• Documentación para desarrolladores — configuración oficial del SDK y MCP junto con autenticación y cuotas
• Referencia de la API — inspeccionar los contratos actuales de solicitud y respuesta de análisis y reproducción
• Instantánea de OpenAPI — contrato en inglés legible por máquina
• Python SDK — punto de entrada oficial del paquete
• TypeScript / JavaScript SDK — punto de entrada oficial del paquete
• Servidor MCP — punto de entrada oficial del paquete
• Guía de la API de revisión de manos de póker — integrar el historial de manos estructurado y las instantáneas en un flujo de trabajo posterior a la sesión
• llms.txt — punto de acceso conciso para LLM