Como analiso a textura do board com a API PokerKit?
Envie um board de flop, turn ou river para POST /v1/pokerkit/texture para receber campos documentados de textura categórica e formato de naipes para esse board.
board, como AsKsQs, para POST /v1/pokerkit/texture. Leia o result retornado como campos de descrição do board — não como equity, uma estratégia GTO ou uma recomendação de ação ao vivo.Fatos rápidos
| Ponto de extremidade | POST /v1/pokerkit/texture |
|---|---|
| Entrada obrigatória | board: uma string sem separadores com 3, 4 ou 5 cartas comunitárias, por exemplo AsKsQs |
| Entrada opcional | hand_type e dead, conforme definido no esquema OpenAPI público |
| Resposta | Um objeto result com cartas, campos categóricos de textura e booleanos de formato de naipes |
| Limite de uso | Somente para treinamento, coaching, revisão de mãos, estudo e pesquisa; sem RTA com dinheiro real |
Semântica da entrada
board é obrigatório. Concatene códigos padrão de cartas de dois caracteres sem separadores: três cartas descrevem um flop, quatro um turn e cinco um river. O esquema público também permite hand_type e dead opcionais; omita-os, a menos que seu fluxo de trabalho documentado precise deles. Não envie hole cards para este endpoint: ele descreve o board, não a mão de um jogador.
Solicitação mínima
Use JSON e uma chave de API. Este corpo de solicitação e a resposta abaixo são o exemplo público de código de documentação pokerkitTexture.
curl -s https://pokerai.bet/v1/pokerkit/texture \
-H "Authorization: Bearer $POKERAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"board":"AsKsQs"}'Interpretação da resposta
{"result":{"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}}cards normaliza o board fornecido em um array. Os campos wetness (dinamismo do board), connectivity, rank_band, straight_draw e flush_draw são descritores categóricos com name e value de exibição. Os três booleanos descrevem o formato dos naipes do board retornado. Neste exemplo, are_monotone é verdadeiro, enquanto are_two_tone e are_rainbow são falsos. Esses rótulos descrevem esta entrada; eles não calculam equity nem selecionam uma ação de poker.
Quando usar
Use Texture quando um fluxo de treinamento, coaching ou revisão de mãos concluídas precisar de uma descrição consistente do board antes de apresentar outras análises documentadas. Se precisar de uma visão geral combinada do board, examine o contrato público separado POST /v1/pokerkit/board-report; se precisar de análise específica do jogador, examine os contratos públicos de hand-report, draws, outs ou blockers.
Quando não usar
Não trate um rótulo de texture como uma estimativa de equity, um resultado de solver, uma garantia de força da mão ou uma jogada recomendada. Texture não substitui uma solicitação a um endpoint documentado de equity, GTO ou mão do jogador e não deve ser usada para assistência em decisões ao vivo com dinheiro real.
Cotas e erros
Este endpoint usa a mesma chave de API e o mesmo sistema de cotas da conta da API pública PokerKit. Consulte a documentação de cotas, os preços e o painel para limites e uso atuais da conta, em vez de codificar um limite no cliente.
| Sinal | Significado | O que fazer |
|---|---|---|
| 422 | O contrato público do OpenAPI declara uma resposta de erro de validação. | Verifique board e quaisquer campos opcionais em relação à Referência ou ao esquema OpenAPI atual e corrija a solicitação. |
| Outros erros de API | A autenticação e o tratamento de cotas da conta são documentados no nível da API. | Use a documentação de erros atual e o status do painel; não tente novamente uma solicitação inválida inalterada. |
SDK, MCP e recursos relacionados
- Documentação para desenvolvedores — configuração oficial de SDK e MCP, além de autenticação e cotas.
- Referência da API — examine o contrato atual de solicitação e resposta de Texture.
- Snapshot do OpenAPI — contrato em inglês legível por máquina.
- SDK Python, SDK TypeScript / JavaScript e servidor MCP — pontos de entrada oficiais dos pacotes.
- Guia da API de revisão de mãos de poker — insira a semântica do board em um fluxo de trabalho pós-sessão.
- llms.txt — ponto de entrada conciso para LLM.