Como solucionar erros da API Pokerai?
Use primeiro a resposta HTTP pública e o esquema da operação; os status de progresso do solver são separados do corpo de erro compartilhado.
Error possui error e pode incluir message; status, spot_status e node_status do solver são campos de resposta separados.Fatos rápidos
| Fato | Contrato público |
|---|---|
| Corpo do erro | O schema compartilhado Error documenta error e message. Não presuma que qualquer campo tenha uma estrutura não publicada ou que todas as operações retornem campos idênticos. |
| Autenticação | 401 significa uma chave de API ausente ou inválida para operações que declaram Unauthorized. |
| Validação | 400 está documentado para entrada inválida ou campo ausente nas operações GTO aplicáveis. Verifique o schema de solicitação atual da operação. |
| Quota e capacidade | 429 está documentado para esgotamento da quota mensal nas operações aplicáveis; o agendamento do solver também pode retornar { "status": "busy" }. |
| Progresso do solver | status, spot_status e node_status descrevem o fluxo de trabalho assíncrono do solver, não o schema compartilhado Error. |
Solicitação e resposta mínimas com falha
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" }Esse formato mínimo de falha usa o exemplo público do campo Error. Não registre chaves de API ou cabeçalhos de solicitação ao diagnosticá-lo.
Limites de autenticação, validação e quota
| HTTP | Significado público | Próxima verificação |
|---|---|---|
| 400 | Entrada inválida ou campo ausente. | Compare o corpo JSON com o schema de solicitação atual da Referência ou do OpenAPI da operação. |
| 401 | Chave de API ausente ou inválida. | Envie um cabeçalho de chave compatível; consulte Autenticação. |
| 404 | Não há dados GTO para uma situação ou board nas operações que declaram NoSolution. | Verifique a situação ou o board enviado em relação à cobertura documentada dessa operação. |
| 429 | Quota mensal excedida ou status: busy quando todos os hosts de solver estão ocupados para o agendamento do solver. | Para quota, consulte Quotas e o painel. Para busy, trate-o como um estado de capacidade e siga o contrato atual da operação do solver; esta página não oferece garantia de tempo de nova tentativa. |
| 502 / 503 | 502 é um backend temporariamente indisponível nas operações aplicáveis. 503 pode informar upstream_unavailable após as próprias tentativas do serviço. | O contrato OpenAPI marca o caso de upstream 503 como passível de nova tentativa; não infira contagem de tentativas, atraso ou SLA. |
O status do solver não é um código de erro
Após POST /v1/gto/solver, o agendamento pode retornar valores de status computing, queryable ou busy. Consulte POST /v1/gto/solver/tree até que spot_status seja queryable. O contrato público da árvore também define available, computing, expired e no_nodes; no_nodes é terminal, portanto interrompa as consultas. As respostas de node definem separadamente valores de node_status, incluindo error, com message presente para esse estado de node.
Um node expired significa que a resolução foi removida pelo sistema ou substituída; o contrato público indica reagendar. Não traduza status do solver como uma promessa sobre tempo de conclusão, capacidade ou cobranças além da documentação pública atual do endpoint.
Uso seguro e escalonamento
Use a API Pokerai para treinamento, coaching, revisão de mãos, estudo e pesquisa. Assistência em tempo real com dinheiro real (RTA) é proibida. Para uma questão não resolvida sobre o contrato público, guarde o endpoint, o status HTTP e o corpo de resposta com dados ocultados e use o canal oficial de Contato; nunca inclua uma chave de API.
Documentação relacionada
- Central da documentação — fluxo de trabalho da API e guias de tópicos.
- Autenticação e Quotas — limites de chaves e contadores mensais.
- Referência da API — detalhes de resposta por operação.
- Snapshot do OpenAPI — contrato público legível por máquina.
- Registro de alterações — alterações publicadas da API e da documentação.
Real-time assistance at real-money tables is prohibited.