¿Cómo me autentico con Pokerai API?
Crea una clave de API en el panel de control, mantenla en secreto y envíala con cada solicitud de API.
Respuesta directa: envía tu clave de API
gto_… como Authorization: Bearer $POKERAI_API_KEY. X-API-Key es una alternativa equivalente; usa un encabezado, no ambos.Datos clave
| Dato | Valor |
|---|---|
| Dónde crear una clave | Panel de control; la clave se muestra una sola vez, así que guárdala en un gestor de secretos. |
| Encabezado | Authorization: Bearer $POKERAI_API_KEY |
| Alternativa | X-API-Key: $POKERAI_API_KEY (equivalente; envía una sola forma). |
| Se aplica a | Los endpoints de GTO y PokerKit comparten la misma clave. |
| Cuota gratuita | 1.000 consultas pre-resueltas + 25 resoluciones en tiempo real al mes. |
Solicitud autenticada mínima
curl -s https://pokerai.bet/v1/gto/preflop \
-H "Authorization: Bearer $POKERAI_API_KEY" \
-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}]}'Errores de autenticación
| HTTP | Error | Qué hacer |
|---|---|---|
| 401 | missing_api_key | Añade un encabezado de clave de API compatible. |
| 401 | invalid_api_key | Comprueba la clave copiada y su variable de entorno; crea un reemplazo si es necesario. |
| 502 | auth_unavailable | Vuelve a intentarlo con espera exponencial; no expongas la clave en los registros. |
Documentación relacionada
- Centro de documentación — inicio rápido y conceptos de endpoints.
- Cuotas — lo que puede consumir cada llamada autenticada.
- Referencia de la API — requisitos de seguridad de los endpoints y formularios de solicitud en vivo.
- Instantánea de OpenAPI — esquemas de seguridad Bearer y de clave de API legibles por máquina.
Real-time assistance at real-money tables is prohibited.