Como valido e normalizo strings de cartas de pôquer com a API Pokerai?

Envie uma string compacta de cartas ao endpoint público de normalização do PokerKit antes de usá-la em um fluxo de trabalho que reconhece cartas.

Atualizado 28 de julho de 2026Mantido por Pokerai API

Resposta direta: chame POST /v1/pokerkit/cards/normalize com a string cards obrigatória. O exemplo público de CardsRequest é AsKsQs; use a Referência atual antes de depender de qualquer campo de resposta.

Fatos rápidos

Fato	Contrato público
Operação	`POST /v1/pokerkit/cards/normalize`
Corpo obrigatório	`cards`, uma string.
Exemplo público	`AsKsQs`.
Notação das cartas	Cada carta tem dois caracteres: valor `AKQJT98765432` seguido do naipe `c`, `d`, `h`, ou `s`; concatene as cartas sem separadores.
Formato de sucesso	O HTTP `200` está documentado, mas seu esquema público do OpenAPI é aberto. Trate os campos JSON retornados como dados de resposta a serem inspecionados, não como um contrato fixo no nível de campo.

Solicitação mínima com suporte do OpenAPI

curl -s https://pokerai.bet/v1/pokerkit/cards/normalize \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cards":"AsKsQs"}'

Esta solicitação usa o exemplo público CardsRequest. Uma chamada real bem-sucedida retorna JSON com HTTP 200; como o snapshot público atual deixa deliberadamente esse esquema de resposta aberto, inspecione o JSON efetivamente retornado e não codifique de forma fixa nomes de campos não documentados.

Entrada aceita e limite da normalização

Use cartas compactas de dois caracteres, como As, Kd e Th, concatenadas em uma única string, como AsKsQs. Este endpoint valida e normaliza a entrada de cartas; ele não calcula equidade, avalia uma mão, recomenda uma ação nem infere uma estratégia.

Erros comuns e privacidade

Sinal	Contrato público	O que fazer
HTTP `422`	`HTTPValidationError`	Verifique se `cards` está presente e é uma string JSON; depois, compare a notação enviada com a Referência atual.
Autenticação	A operação lista os cabeçalhos de solicitação `Authorization` e `X-API-Key`.	Envie um cabeçalho de chave de API compatível; consulte Autenticação.
Privacidade	As cartas podem ser dados sensíveis de jogo ou de usuário.	Envie somente o necessário, mantenha as chaves de API fora dos corpos de solicitação e logs, e oculte strings de cartas no material de suporte quando puderem identificar um jogador ou histórico de mãos.

Use a normalização em fluxos de trabalho de treinamento, coaching, revisão de mãos, estudo e pesquisa. Ela não é assistência em tempo real com dinheiro real (RTA), não fornece estratégia e não deve ser usada para orientar ações em mesas ao vivo.

Documentação relacionada

Central de documentação — visão geral da API PokerKit e GTO.
Guia de análise de mãos de pôquer — use a entrada de cartas normalizada em fluxos de análise pós-sessão.
Referência da API — detalhes atuais da solicitação e resposta no nível da operação.
Snapshot do OpenAPI — o CardsRequest público e o contrato de resposta.
SDK Python, SDK TypeScript / JavaScript, e servidor MCP — pontos de entrada oficiais dos pacotes.

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