Documentação da API de Poker
Guia completo para integração com a API do AI Poker Tools
Visão Geral
A API do AI Poker Tools oferece acesso programático a cálculos avançados de poker, análise de odds e avaliação do estado do jogo. Nossa API é projetada para desenvolvedores que desejam integrar análises sofisticadas de poker em suas aplicações.
URL Base
Autenticação
Todas as requisições à API exigem autenticação usando sua chave de API. Inclua sua chave nos headers da requisição:
Endpoints
POST /api/v1/probabilities
Calcula as probabilidades de mãos de poker para as cartas fornecidas usando simulação de Monte Carlo.
Corpo da Requisição:
{
"cards": ["Ah", "Kh"]
}Resposta:
{
"success": true,
"data": {
"cards": ["Ah", "Kh"],
"probabilities": {
"Flush": 0.06486,
"Four of a Kind": 0.00127,
"Full House": 0.022,
"High Card": 0.18114,
"One Pair": 0.43388,
"Straight": 0.03136,
"Straight Flush": 0.00044,
"Three of a Kind": 0.04321,
"Two Pair": 0.22184
},
"simulations": 100000
}
}POST /api/v1/probabilities-enhanced
Calcula estatísticas avançadas de poker, incluindo taxas de vitória contra múltiplos oponentes e detalhamento das probabilidades de mãos tanto para o jogador quanto para os oponentes.
Corpo da Requisição:
{
"cards": ["Kh", "Kc"],
"opponents": 3
}Resposta:
{
"success": true,
"data": {
"cards": ["Kh", "Kc"],
"opponents": 3,
"win_rate": 0.6842,
"tie_rate": 0.0158,
"lose_rate": 0.3000,
"our_hand_probabilities": {
"One Pair": 0.43388,
"Two Pair": 0.22184,
"Three of a Kind": 0.11752,
"Full House": 0.086,
"Four of a Kind": 0.00856,
"Flush": 0.0202,
"Straight": 0.01216,
"Straight Flush": 0.00008
},
"opponent_hand_probabilities": {
"One Pair": 0.08768,
"Two Pair": 0.23586,
"Three of a Kind": 0.16442,
"Straight": 0.2099,
"Flush": 0.13536,
"Full House": 0.1494,
"Four of a Kind": 0.01494,
"Straight Flush": 0.00244
}
}
}Demo Interativa
Experimente a API com esta calculadora interativa de odds de poker. Selecione suas cartas e as cartas da mesa para ver os cálculos de probabilidade em tempo real.
Calculadora de Odds de Poker
Selecione suas cartas de mão e as cartas comunitárias para calcular as probabilidades de vitória
Suas Cartas
Cartas Comunitárias
Demo Avançada - Análise de Taxa de Vitória
Experimente a API avançada que calcula taxas de vitória contra múltiplos oponentes e mostra detalhamentos de probabilidade de mãos tanto para você quanto para seus oponentes.
Análise Avançada de Poker
Selecione suas cartas e o número de oponentes para ver taxas de vitória e comparações de probabilidade
Suas Cartas
Cartas Comunitárias
Número de Oponentes
Convenções de Nomenclatura das Cartas
Todas as cartas na API utilizam um formato padronizado de dois caracteres: Valor + Naipe
Valores
Ás
Rei
Dama
Valete
Dez
Nove a Dois
Naipes
Copas ♥
Ouros ♦
Paus ♣
Espadas ♠
Exemplos
Formatos de Mensagem
Formato da Requisição
Todas as requisições POST devem usar formato JSON com Content-Type: application/json
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
{
"parameter": "value"
}Formato da Resposta
Todas as respostas são retornadas em formato JSON:
{
"success": true,
"data": {
// Response data here
}
}Formato de Erro
{
"success": false,
"error": {
"code": "INVALID_CARDS",
"message": "Invalid card format provided",
"details": "Card 'Xh' is not a valid card"
}
}Códigos de Erro
| Código | Descrição |
|---|---|
INVALID_API_KEY |
Chave de API ausente ou inválida |
INVALID_CARDS |
Uma ou mais cartas possuem formato inválido |
DUPLICATE_CARDS |
A mesma carta aparece múltiplas vezes |
RATE_LIMIT_EXCEEDED |
Muitas requisições no intervalo de tempo |
INSUFFICIENT_CREDITS |
A conta não possui créditos de API suficientes |
Exemplos de Código
Python
import requests
import json
url = "https://www.aipokertools.com/api/v1/probabilities"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
data = {
"cards": ["Ah", "Kh"]
}
response = requests.post(url, headers=headers, json=data)
result = response.json()
if result['success']:
probabilities = result['data']['probabilities']
print(f"One Pair: {probabilities['One Pair']:.2%}")
print(f"Two Pair: {probabilities['Two Pair']:.2%}")
print(f"Flush: {probabilities['Flush']:.2%}")
else:
print(f"Error: {result['error']['message']}")JavaScript
const response = await fetch('https://www.aipokertools.com/api/v1/probabilities', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
cards: ['Ah', 'Kh']
})
});
const result = await response.json();
if (result.success) {
const probabilities = result.data.probabilities;
console.log(`One Pair: ${(probabilities['One Pair'] * 100).toFixed(1)}%`);
console.log(`Two Pair: ${(probabilities['Two Pair'] * 100).toFixed(1)}%`);
console.log(`Flush: ${(probabilities['Flush'] * 100).toFixed(1)}%`);
} else {
console.error(`Error: ${result.error.message}`);
}