← Todos os guias
Nesta página
  1. Início
  2. Guias
  3. Como analiso uma mão de poker com uma API?
Guia Semântica do poker · 04/09 Revisão de mão 12 min Intermediário

Como analiso uma mão de poker com uma API?

Envie uma mão de cartas fechadas e um board de flop, turn ou river para POST /v1/pokerkit/hand-report para obter um relatório factual documentado da mão.

Atualizado Mantido por Pokerai API

Resposta direta: para um relatório combinado do Hero, envie hole e board para POST /v1/pokerkit/hand-report. Para tarefas apenas de board, use POST /v1/pokerkit/board-report ou POST /v1/pokerkit/category-combos com board; use POST /v1/pokerkit/hand-tier, POST /v1/pokerkit/draws, POST /v1/pokerkit/outs ou POST /v1/pokerkit/blockers com hole e board; use POST /v1/pokerkit/hand-strength com hole_range; use POST /v1/pokerkit/nuts para a mão mais forte que pode ser formada no board e as combinações que empatam; e use POST /v1/pokerkit/cards/normalize com cards para validar e normalizar strings de cartas. Verifique o schema OpenAPI atual de cada operação antes de interpretar seu result; use mãos concluídas para treinamento ou revisão — não para selecionar ações em uma mesa com dinheiro real.

Informações rápidas

EndpointPOST /v1/pokerkit/hand-report
Entrada obrigatóriahole (duas cartas) e board (3, 4 ou 5 cartas comunitárias), conforme definido pelo schema público HandRequest
Entrada opcionalhand_type e dead, conforme definido pelo esquema público do OpenAPI
Relatório documentadoTextura, nível da mão formada, draws, outs e contexto de bloqueadores para a mão e o board enviados
Limite de usoSomente para treinamento, coaching, revisão de mãos concluídas, estudo e pesquisa; sem RTA com dinheiro real

Semântica de entrada

hole são as duas cartas fechadas do jogador e board é um conjunto de três, quatro ou cinco cartas comunitárias. Concatene códigos padrão de cartas de dois caracteres, sem separadores. O esquema público HandRequest também permite hand_type e dead; omita-os, a menos que um fluxo de trabalho documentado os exija.

Solicitação e resposta mínimas

Esta solicitação curl e resposta são o exemplo público compartilhado de pokerkitHandReport.

curl -s https://pokerai.bet/v1/pokerkit/hand-report \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hole":"JhTh","board":"AsKsQs"}'

{"result":{"texture":{"cards":["As","Ks","Qs"],"wetness":{"name":"WET","value":"Wet"},"connectivity":{"name":"HIGH","value":"High"},"rank_band":{"name":"HIGH","value":"High"},"straight_draw":{"name":"OPEN_ENDED","value":"Open-ended"},"flush_draw":{"name":"LIVE","value":"Live"},"are_two_tone":false,"are_monotone":true,"are_rainbow":false},"tier":{"category":{"name":"STRAIGHT","value":"Straight"},"is_nut":false,"nut_rank":{"name":"NON_NUT","value":"Non-nut"}},"draws":{"straight_draw":null,"flush_draw":null,"nut_rank":null},"outs":{"by_category":{},"count":0}}}

Como interpretar o relatório

texture descreve o board fornecido: suas cartas, dinamismo categórico do board, conectividade, faixa de ranks, draws de sequência e flush disponíveis e booleanos da forma dos naipes. tier classifica a mão formada; no exemplo, category é Straight e is_nut é false. draws registra os rótulos de draws de sequência ou flush restantes e seu nut rank; null aqui significa que o exemplo não informa nenhum dos dois draws. outs agrupa as cartas de melhoria por categoria e fornece count; este exemplo tem um grupo vazio e zero outs.

A documentação pública descreve o Hand Report como a visão geral combinada do Hero para textura, nível, draws, outs e blockers. O exemplo de resposta pública compartilhado acima não inclui um membro blockers, portanto os clientes não devem exigir um. Para inspecionar os campos de blockers documentados, use o contrato separado POST /v1/pokerkit/blockers: ele informa os totais de nut combos e as contagens bloqueadas, as cartas blocker, uma fração de bloqueio e se o Hero bloqueia as nuts.

Quando usar

Use o Hand Report para anotar uma mão concluída em uma ferramenta de treinamento, ferramenta de coaching, revisão de histórico de mãos, caderno de estudos ou fluxo de pesquisa. Ele é útil quando a interface precisa de rótulos factuais do board e da mão antes de apresentar outras análises documentadas separadamente.

Quando não usá-lo

Não trate campos descritivos como equity, resultado de solver, garantia ou jogada recomendada. Não conecte este endpoint a um feed de mesa ao vivo, não automatize uma ação com base em sua saída nem o use para assistência em tempo real com dinheiro real.

Cota e erros

Hand Report usa a mesma chave de API e o mesmo sistema de cotas de conta da API pública PokerKit. Consulte a documentação sobre cotas, os preços e o painel para ver os limites e o uso atuais da conta, em vez de codificar um limite fixo. O contrato público OpenAPI declara uma resposta de validação 422; corrija hole, board e os campos opcionais de acordo com a Referência ou o esquema OpenAPI atual. Para erros de autenticação e de cota, use a documentação sobre erros atual e não tente novamente uma solicitação inválida inalterada.

SDK, MCP e recursos relacionados

Documentação para desenvolvedores fornece a configuração oficial de SDK e MCP, além de autenticação e cotas. Consulte a operação atual na Referência da API e o snapshot do OpenAPI legível por máquina. Os pontos de entrada oficiais são o SDK Python, o SDK TypeScript / JavaScript e o servidor MCP.

Sem RTA com dinheiro real

Pokerai API destina-se apenas a treinamento, coaching, revisão de mãos, estudo e pesquisa. A assistência em tempo real em mesas com dinheiro real é proibida. Mantenha a saída da análise de mãos fora da automação de mesas ao vivo e não a apresente como uma instrução de ação ao vivo.

Operações públicas relacionadas

Use estes contratos públicos separados quando uma revisão precisar de um resultado factual mais específico.

Ponto de extremidadeTarefaUso
POST /v1/pokerkit/hand-reportAnalisar uma mão e o boardRetorne o relatório documentado combinado da mão.
POST /v1/pokerkit/blockersInspecionar evidências de blockersLeia separadamente os campos documentados de bloqueadores de combinações nuts.

Recursos relacionados