¿Cómo soluciono los errores de Pokerai API?
Usa primero la respuesta HTTP pública y el esquema de la operación; los estados de progreso del solver son independientes del cuerpo de error compartido.
Error tiene error y puede incluir message; status, spot_status y node_status del solver son campos de respuesta independientes.Datos rápidos
| Hecho | Contrato público |
|---|---|
| Cuerpo de error | El esquema compartido Error documenta error y message. No suponga que alguno de los dos campos tenga una estructura no publicada ni que cada operación devuelve campos idénticos. |
| Autenticación | 401 significa que falta una clave de API o que no es válida para las operaciones que declaran Unauthorized. |
| Validación | 400 está documentado para entradas no válidas o un campo faltante en las operaciones GTO aplicables. Compruebe el esquema de solicitud actual de esa operación. |
| Cuota y capacidad | 429 está documentado para el agotamiento de la cuota mensual en las operaciones aplicables; la programación del solver también puede devolver { "status": "busy" }. |
| Progreso del solver | status, spot_status y node_status describen el flujo de trabajo asíncrono del solver, no el esquema compartido Error. |
Solicitud y respuesta mínima fallida
curl -s https://pokerai.bet/v1/gto/preflop \
-H "Content-Type: application/json" \
-d '{"hole_cards":"AhKh","positions":{"hero":"UTG"},"preflop_actions":[{"position":"SB","action":"small blind","amount":0.5},{"position":"BB","action":"big blind","amount":1}]}'
HTTP 401
{ "error": "missing_api_key" }Este formato de fallo mínimo utiliza el ejemplo de campo Error público. No registre claves de API ni encabezados de solicitud al diagnosticarlo.
Límites de autenticación, validación y cuota
| HTTP | Significado público | Siguiente comprobación |
|---|---|---|
| 400 | Entrada no válida o campo faltante. | Compare el cuerpo JSON con el esquema de solicitud de Referencia u OpenAPI actual de la operación. |
| 401 | Falta una clave de API o no es válida. | Envíe un encabezado de clave compatible; consulte Autenticación. |
| 404 | No hay datos GTO para una situación o cartas comunitarias en las operaciones que declaran NoSolution. | Compruebe la situación o cartas comunitarias enviadas con la cobertura documentada de esa operación. |
| 429 | Cuota mensual superada, o status: busy cuando todos los hosts del solver están ocupados para la programación del solver. | Para la cuota, consulte Cuotas y el panel. Para busy, trátelo como un estado de capacidad y siga el contrato de operación actual del solver; esta página no garantiza ningún tiempo de reintento. |
| 502 / 503 | 502 es un backend temporalmente no disponible en las operaciones aplicables. 503 puede informar upstream_unavailable después de los propios reintentos del servicio. | El contrato OpenAPI marca el caso del servicio upstream 503 como reintentable; no infiera un número de reintentos, una demora ni un SLA. |
El estado del solver no es un código de error
Después de POST /v1/gto/solver, la programación puede devolver los valores de status computing, queryable o busy. Consulte POST /v1/gto/solver/tree hasta que spot_status sea queryable. El contrato público del árbol también define available, computing, expired y no_nodes; no_nodes es terminal, así que deje de consultar. Las respuestas de nodo definen por separado valores de node_status, incluido error, con message presente para ese estado de nodo.
Un nodo expired significa que el cálculo fue retirado o reemplazado; el contrato público indica que se reprograme. No traduzca los estados del solver en una promesa sobre el tiempo de finalización, la capacidad o los cargos más allá de la documentación pública actual del endpoint.
Uso seguro y escalamiento
Use Pokerai API para entrenamiento, coaching, revisión de manos, estudio e investigación. La asistencia en tiempo real con dinero real (RTA) está prohibida. Para una pregunta no resuelta sobre el contrato público, conserve el endpoint, el estado HTTP y el cuerpo de respuesta con información sensible ocultada, y después use el canal oficial de Contacto; nunca incluya una clave de API.
Documentación relacionada
- Centro de documentación — flujo de trabajo de la API y guías temáticas.
- Autenticación y Cuotas — límites de claves y del contador mensual.
- Referencia de la API — detalles de respuestas a nivel de operación.
- Instantánea de OpenAPI — contrato público legible por máquinas.
- Registro de cambios — cambios publicados de la API y la documentación.
Real-time assistance at real-money tables is prohibited.