Como faço a autenticação com a API Pokerai?

Crie uma chave de API no painel, mantenha-a em segredo e envie-a com cada solicitação de API.

Atualizado 26 de julho de 2026Mantido por Pokerai API

Resposta direta: envie sua chave de API gto_… como Authorization: Bearer $POKERAI_API_KEY. X-API-Key é uma alternativa equivalente; use um cabeçalho, não ambos.

Fatos rápidos

Fato	Valor
Onde criar uma chave	Painel; a chave é exibida uma única vez, portanto armazene-a em um gerenciador de segredos.
Cabeçalho	`Authorization: Bearer $POKERAI_API_KEY`
Alternativa	`X-API-Key: $POKERAI_API_KEY` (equivalente; envie apenas uma forma).
Aplicável a	Os endpoints GTO e PokerKit compartilham a mesma chave.
Cota gratuita	1.000 consultas pré-resolvidas + 25 resoluções em tempo real por mês.

Solicitação 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}]}'

Erros de autenticação

HTTP	Erro	O que fazer
401	`missing_api_key`	Adicione um cabeçalho de chave de API aceito.
401	`invalid_api_key`	Verifique a chave copiada e sua variável de ambiente; crie uma substituta se necessário.
502	`auth_unavailable`	Tente novamente com recuo exponencial; não exponha a chave nos logs.

Documentação relacionada

Central de documentação — início rápido e conceitos de endpoint.
Cotas — o que cada chamada autenticada pode consumir.
Referência da API — requisitos de segurança de endpoint e formulários interativos para enviar solicitações.
Instantâneo OpenAPI — esquemas de segurança Bearer e de chave de API legíveis por máquina.

Real-time assistance at real-money tables is prohibited.