← Todas las guías
En esta página
  1. Inicio
  2. Guías
  3. ¿Cómo debo gestionar los errores y reintentos de Pokerai API?
Guía Empieza aquí · 02/06 Plataforma 7 min Intermedio

¿Cómo debo gestionar los errores y reintentos de Pokerai API?

Primero, lea el estado HTTP y el contrato de la operación actual: corrija las respuestas documentadas 400 y 401, distinga el agotamiento de cuota de la capacidad del solver en 429 y vuelva a intentarlo solo en los casos transitorios 5xx aplicables, sin asumir un número de reintentos ni un SLA.

Actualizado Mantenido por Pokerai API

Respuesta directa: Use la Referencia actual o la instantánea de OpenAPI para la operación que llamó. El esquema Error público compartido documenta error y puede incluir message; no infiera un vocabulario de códigos de error no publicado ni campos de respuesta idénticos para cada operación.

Datos rápidos

Formato de errorEl esquema público compartido Error tiene error y puede incluir message.
400 / 401Para las operaciones aplicables, 400 documenta una entrada no válida o un campo faltante; 401 documenta una clave de API faltante o no válida.
429Las operaciones aplicables documentan el agotamiento de la cuota mensual; la programación del solver también puede devolver { "status": "busy" } cuando todos los hosts del solver están ocupados.
5xxAlgunas operaciones aplicables documentan un backend temporalmente no disponible (502) o una respuesta upstream_unavailable que se puede reintentar (503).
CuotaLos contadores de cuota públicos son mensuales; la respuesta de cuota de OpenAPI indica que se restablecen el día 1. Consulta el panel y la documentación sobre cuotas para conocer el estado actual de la cuenta.
Límite de usoSolo para entrenamiento, coaching, revisión de manos, estudio e investigación; no para RTA con dinero real.

Solicitud mínima y respuesta de error con datos ocultos

Esto omite deliberadamente las credenciales. Demuestra el límite de autenticación pública sin exponer una clave ni una cabecera de solicitud.

curl -i -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}]}'

El ejemplo de OpenAPI Error admite esta forma de respuesta con datos ocultos para una clave faltante:

HTTP 401
{ "error": "missing_api_key" }

Nunca registre claves de API, encabezados Authorization ni cuerpos de solicitudes de clientes sin ocultar mientras diagnostica un error.

Principios seguros de reintento y espera exponencial

Vuelve a intentarlo solo después de clasificar la respuesta conforme al contrato de la operación actual. Para un 502 transitorio aplicable o un 503 reintentable, usa un retroceso exponencial limitado con fluctuación que controle tu aplicación. Para la programación del solver con 429 y status: busy, trátalo como un estado de capacidad y vuelve a intentarlo más tarde, en lugar de asumir que se trata de agotamiento de cuota.

No prometas ni codifiques de forma fija un número de intentos, una demora, un SLA, el comportamiento de idempotencia ni el significado de un código de error más allá del contrato público actual. Antes de volver a enviar una solicitud que podría consumir cuota o cambiar el estado del flujo de trabajo, decide en tu propia aplicación si es seguro repetirla.

Cuándo no reintentar

No vuelva a intentar un 400 aplicable sin cambios: compare la carga útil con el esquema de solicitud actual y corrija la entrada no válida o ausente. No vuelva a intentar un 401 aplicable hasta haber corregido el encabezado o la clave de API admitidos.

No trate cada 429 como reintentable. Cuando la respuesta sea un agotamiento de cuota documentado, consulte en su lugar el panel, el plan y el límite de restablecimiento mensual. Una forma de respuesta como status: busy pertenece al flujo de trabajo documentado de programación del solver, no al esquema de error compartido.

Cuota y estado del solver

Pokerai API contabiliza las consultas pre-resueltas por separado de los cálculos en tiempo real. La respuesta pública de cuota describe un contador mensual que se restablece el día 1; utiliza el panel y los precios para consultar los límites actuales de la cuenta, en lugar de codificar un límite de forma fija en un cliente.

Los campos de flujo de trabajo status, spot_status y node_status son distintos del esquema compartido Error. Siga los contratos documentados de solver, tree y node en lugar de interpretar esos estados como una garantía de tiempo de finalización o de cobro.

Sin RTA con dinero real

Usa Pokerai API 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. La gestión de errores y la lógica de reintento no deben usarse para automatizar consejos en mesas en vivo.

Guía de estados documentados

Estas descripciones se aplican solo cuando la lista actual de respuestas OpenAPI de la operación las declara.

HTTPContrato públicoSiguiente paso seguro
400Entrada no válida o campo faltante.Corrija la discrepancia con el esquema de solicitud; no vuelva a intentarlo sin cambios.
401Clave de API faltante o no válida.Corrige la autenticación; no vuelvas a intentarlo con la misma credencial ausente o no válida.
429Agotamiento de la cuota mensual en operaciones aplicables; la programación del solver puede informar en su lugar status: busy.Para la cuota, revise el panel y el límite de restablecimiento. Para el busy documentado, use una espera prudente sin una promesa fija de reintento.
502 / 503Las operaciones aplicables documentan un backend temporalmente no disponible o upstream_unavailable reintentable.Utiliza un retroceso exponencial acotado con fluctuación, controlado por la aplicación; vuelve a comprobar el contrato actual de la operación.

SDK, documentación y referencia