Como analiso e reproduzo históricos de mãos .phh do PokerKit com uma API?

Informações rápidas

Análise versus reprodução

Use parse quando sua entrada for uma string de texto .phh do PokerKit e você precisar da configuração estruturada, incluindo campos documentados como variant, blinds, stacks iniciais e actions. Use replay quando precisar de uma visualização de estado do histórico enviado: ele pode aceitar o text de origem ou diretamente os campos de configuração documentados e actions.

Estes endpoints têm funções diferentes. A análise não cria uma linha do tempo de revisão nem uma recomendação de poker. A reprodução reconstrói o estado a partir do histórico fornecido; ela não converte a mão em estratégia de solver, equity ou recomendação de ação.

Solicitação e resposta de análise mínimas

Use JSON e uma chave de API. Esta solicitação e resposta são o exemplo público de código de documentação pokerkitNotationParse.

curl -s https://pokerai.bet/v1/pokerkit/notation/parse \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"variant = \"NT\"\nactions = [\"d dh p1 AhKh\", \"d dh p2 QsQd\"]\n"}'

{"result":{"variant":"NT","actions":["d dh p1 AhKh","d dh p2 QsQd"]}}

O exemplo completo de código da documentação pública contém campos analisados adicionais. Trate a configuração retornada como a representação estruturada da notação enviada e consulte a Referência atual ou o snapshot do OpenAPI para ver o contrato completo.

Reproduza uma mão para exibição ou revisão

Replay pode receber uma string .phh em text ou os campos de configuração documentados e actions. Forneça o index opcional somente quando precisar do snapshot em um índice de etapa documentado.

curl -s https://pokerai.bet/v1/pokerkit/notation/replay \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"variant":"NT","antes":[0,0],"blinds_or_straddles":[1,2],"min_bet":2,"starting_stacks":[200,200],"actions":["d dh p1 AhKh","d dh p2 QsQd","p2 cbr 6","p1 f"],"index":2}'

{"result":{"snapshot":{"terminal":false,"street_index":0,"pot":3,"bets":[2,1],"stacks":[198,199],"board":[],"hole_cards":[{"player":0,"cards":["Ah","Kh"]},{"player":1,"cards":["Qs","Qd"]}]},"step_count":5}}

Use os campos de snapshot, como pote, apostas, stacks, board e ações permitidas, para renderizar o histórico enviado. O step_count do exemplo é a contagem documentada para essa lista de ações enviada.

Limite de informações completas

A reprodução é uma reconstrução completa das informações do que você envia. No exemplo de resposta pública, snapshot.hole_cards contém as cartas dos jogadores enviadas. Ela é apropriada para uma interface de exibição ou revisão somente quando essas informações pertencem ao fluxo de trabalho da mão concluída enviada.

Não apresente replay como inferência de cartas ocultas, simulação com informações parciais, garantia de precisão de resultados ou ferramenta de decisão ao vivo. Ele reconstrói o estado documentado a partir da notação ou configuração e das ações fornecidas.

Quando usar — e quando não usar

Use estes endpoints para importação de histórico de mãos pós-sessão, uma linha do tempo de revisão de mãos, uma exibição para coaching ou estudo, ou ferramentas de pesquisa que precisam de um registro de notação estruturada do PokerKit e de seu estado reconstruído.

Não os use para alegar suporte a outro formato de histórico de mãos, inferir informações ausentes da mão, fornecer assistência ao vivo com dinheiro real ou transformar snapshots em instruções de apostas. Eles não substituem um endpoint separado e documentado quando sua tarefa é estratégia GTO, equidade ou avaliação de mãos.

Erros e contrato atual

Ambas as operações públicas do OpenAPI declaram uma resposta de erro de validação 422. Para parse, verifique se text está presente e está em conformidade com a notação .phh do PokerKit. Para replay, verifique text ou os campos de configuração documentados, actions e o index opcional em relação ao esquema atual da Referência ou do OpenAPI antes de corrigir e reenviar.

Use a documentação atual de autenticação, cotas e erros para o tratamento no nível da conta. Não tente novamente uma solicitação inválida inalterada.

Sem RTA com dinheiro real

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

Endpoints relacionados

Use o contrato público atual de cada endpoint em vez de inferir suporte adicional a formatos ou análises.

SDK, MCP e recursos relacionados

• Documentação para desenvolvedores — configuração do SDK e MCP oficiais, além de autenticação e cotas
• Referência da API — inspecione os contratos atuais de solicitação e resposta de análise e reprodução
• Instantâneo do OpenAPI — contrato em inglês legível por máquina
• Python SDK — ponto de entrada oficial do pacote
• TypeScript / JavaScript SDK — ponto de entrada oficial do pacote
• Servidor MCP — ponto de entrada oficial do pacote
• Guia da API de revisão de mãos de poker — coloque o histórico de mãos estruturado e os instantâneos em um fluxo de trabalho pós-sessão
• llms.txt — ponto de entrada conciso para LLM