← Todas las guías
En esta página
  1. Inicio
  2. Guías
  3. ¿Cómo obtengo proyectos, cartas de mejora y bloqueadores de póker con una API?
Guía Semántica del póker · 05/09 Revisión de manos 10 min Intermedio

¿Cómo obtengo proyectos, cartas de mejora y bloqueadores de póker con una API?

Envía un board de una mano completada y cartas ocultas a las operaciones públicas de PokerKit para obtener etiquetas factuales de proyectos, outs y bloqueadores.

Actualizado Mantenido por Pokerai API

Respuesta directa: envía hole y board a POST /v1/pokerkit/draws, POST /v1/pokerkit/outs o POST /v1/pokerkit/blockers. Estos son contratos públicos de OpenAPI independientes: lee el esquema actual antes de utilizar result y usa las etiquetas solo para entrenamiento, revisión, estudio o investigación, no para seleccionar acciones con dinero real.

Datos rápidos

OperacionesPOST /v1/pokerkit/draws, /outs y /blockers
Entrada obligatoriahole y board, obligatorios según el esquema público HandRequest
Entrada opcionalhand_type y dead cuando el esquema OpenAPI actual los permite
Límite del resultadoSolo etiquetas factuales; no equidad, un resultado garantizado ni una jugada recomendada
Límite de usoSolo entrenamiento, coaching, revisión, estudio e investigación de manos completadas; sin RTA con dinero real

Semántica de entrada

hole son las dos cartas de Hero y board es un board de tres, cuatro o cinco cartas. Usa códigos de cartas estándar de dos caracteres sin separadores. El esquema público compartido HandRequest también documenta hand_type y dead; no inventes formatos de cartas ni campos no compatibles.

Solicitud y respuesta públicas mínimas de OpenAPI

Las tres operaciones comparten el contrato público HandRequest. Esta solicitud mínima usa solo sus campos obligatorios; usa /outs o /blockers en lugar de /draws para los otros resultados específicos y luego inspecciona el esquema de respuesta actual específico de la operación.

POST /v1/pokerkit/draws
Authorization: Bearer $POKERAI_API_KEY
Content-Type: application/json

{"hole":"JhTh","board":"AsKsQs"}

Interpretar los resultados

Trata draws como etiquetas de draws documentadas, outs como categorías y recuentos documentados de cartas de mejora, y blockers como evidencia documentada de bloqueo de combinaciones nuts. Un recuento o una etiqueta no indica probabilidad, rango del oponente, equidad, EV del solver ni una acción recomendada. Mantén los campos como opcionales salvo que el esquema de la operación actual los marque como obligatorios.

Cuándo usarlo

Usa estas operaciones 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. Usa Informe de mano cuando una visión general factual combinada sea más útil que una operación específica.

Cuándo no usarlo

No uses estas etiquetas para estimar la probabilidad de ganar, prometer un resultado, seleccionar una acción en vivo ni admitir un formato de póker no divulgado. No conectes la salida a una fuente de datos de mesa en vivo ni a automatización.

Cuota y errores

Estas operaciones usan la clave de API pública y el sistema de cuotas de la cuenta. Consulta la documentación sobre cuotas, los precios y el panel para conocer los límites actuales; no codifiques un límite de forma fija. El contrato público declara errores de validación: corrige hole, board y los campos opcionales según la Referencia de la API actual; para fallos de autenticación o de cuota, sigue la documentación sobre errores y no reintentes una solicitud no válida que no haya cambiado.

SDK, MCP y recursos relacionados

Documentación para desarrolladores cubre la configuración de SDK y MCP, la autenticación y las cuotas. La referencia de la API y la instantánea de OpenAPI son los contratos públicos vigentes. Puntos de acceso oficiales: Python SDK, TypeScript / JavaScript SDK y servidor MCP.

Sin RTA con dinero real

Pokerai API es solo para entrenamiento, coaching, revisión de manos, estudio e investigación. Está prohibida la asistencia en tiempo real en mesas con dinero real. Nunca presentes proyectos, cartas de mejora o bloqueadores como una instrucción de acción en vivo.

Operaciones públicas relacionadas

Usa el contrato público específico que coincida con la etiqueta factual que necesita tu revisión de mano completada.

Punto de conexiónTareaUso
POST /v1/pokerkit/drawsLeer etiquetas de proyectosDevuelve el resultado documentado de los proyectos para la mano y la mesa enviadas.
POST /v1/pokerkit/outsConsultar outs de mejoraDevuelve las categorías y los recuentos de outs documentados.
POST /v1/pokerkit/blockersLeer evidencia de bloqueadoresDevuelve los campos documentados de bloqueadores de combinaciones nut.

Recursos relacionados