Como obter draws, outs e blockers de poker com uma API?
Envie um board de mão concluída e cartas fechadas às operações públicas do PokerKit para obter rótulos factuais de draws, outs e blockers.
hole e board para POST /v1/pokerkit/draws, POST /v1/pokerkit/outs ou POST /v1/pokerkit/blockers. Estes são contratos OpenAPI públicos separados: leia o esquema atual antes de consumir result e use os rótulos apenas para treinamento, revisão, estudo ou pesquisa — não para seleção de ações com dinheiro real.Fatos rápidos
| Operações | POST /v1/pokerkit/draws, /outs e /blockers |
|---|---|
| Entrada obrigatória | hole e board, exigidos pelo esquema público HandRequest |
| Entrada opcional | hand_type e dead onde o esquema OpenAPI atual os permite |
| Limite do resultado | Apenas rótulos factuais; não são equidade, um resultado garantido ou uma jogada recomendada |
| Limite de uso | Apenas para treinamento, coaching, revisão, estudo e pesquisa com mãos concluídas; sem RTA com dinheiro real |
Semântica de entrada
hole são as duas cartas do Hero, e board é um board com três, quatro ou cinco cartas. Use códigos padrão de cartas com dois caracteres, sem separadores. O esquema público compartilhado HandRequest também documenta hand_type e dead; não invente formatos ou campos de cartas não compatíveis.
Solicitação e resposta mínimas da OpenAPI pública
As três operações compartilham o contrato público HandRequest. Esta solicitação mínima usa apenas os campos obrigatórios; use /outs ou /blockers no lugar de /draws para os outros resultados específicos e, em seguida, inspecione o esquema de resposta atual específico da operação.
POST /v1/pokerkit/draws
Authorization: Bearer $POKERAI_API_KEY
Content-Type: application/json
{"hole":"JhTh","board":"AsKsQs"}Interprete os resultados
Trate draws como rótulos de draws documentados, outs como categorias e contagens documentadas de cartas de melhoria e blockers como evidências documentadas de bloqueio de combinações nut. Uma contagem ou um rótulo não indica probabilidade, range do oponente, equity, EV do solver nem uma ação recomendada. Mantenha os campos opcionais, a menos que o esquema da operação atual os marque como obrigatórios.
Quando usar
Use estas operações para anotar uma mão concluída em um treinador, ferramenta de coaching, revisão de histórico de mãos, caderno de estudos ou fluxo de trabalho de pesquisa. Use Hand Report quando uma visão geral factual combinada for mais útil do que uma operação específica.
Quando não usá-lo
Não use esses rótulos para estimar a probabilidade de vitória, prometer um resultado, selecionar uma ação ao vivo ou dar suporte a um formato de poker não divulgado. Não conecte a saída a um feed de mesa ao vivo nem à automação.
Cota e erros
Essas operações usam a chave de API pública e o sistema de cota da conta. Consulte a documentação de cotas, os preços e o painel para ver os limites atuais; não fixe um limite no código. O contrato público declara erros de validação: corrija hole, board e campos opcionais conforme a Referência da API atual; para falhas de autenticação ou de cota, siga a documentação de erros e não repita uma solicitação inválida inalterada.
SDK, MCP e recursos relacionados
Documentação para desenvolvedores abrange a configuração de SDK e MCP, autenticação e cotas. A Referência da API e o Instantâneo do OpenAPI são os contratos públicos atuais. Pontos de entrada oficiais: SDK Python, SDK TypeScript / JavaScript e servidor MCP.
Sem RTA com dinheiro real
A 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. Nunca apresente draws, outs ou blockers como uma instrução de ação durante uma partida.
Operações públicas relacionadas
Use o contrato público específico que corresponde ao rótulo factual de que sua revisão de mão concluída precisa.
| Ponto de extremidade | Tarefa | Uso |
|---|---|---|
POST /v1/pokerkit/draws | Ler rótulos de draws | Retorne o resultado de draw documentado para a mão e o board enviados. |
POST /v1/pokerkit/outs | Ler outs de melhoria | Retorne as categorias e contagens de outs documentadas. |
POST /v1/pokerkit/blockers | Leia as evidências de bloqueadores | Retorne os campos documentados de bloqueadores de combinações nuts. |
Recursos relacionados
- Documentação para desenvolvedores — autenticação, cotas, SDKs, erros e semântica do PokerKit
- Referência da API — operações atuais de draws, outs e blockers
- Instantâneo do OpenAPI — contrato em inglês legível por máquina
- Guia da API de análise de mãos de poker — fluxo de trabalho combinado e factual do Hand Report
- llms.txt — ponto de entrada conciso para LLM