Documentación de la API de Poker
Guía completa para integrarte con la API de AI Poker Tools
Descripción General
La API de AI Poker Tools proporciona acceso programático a cálculos avanzados de poker, análisis de probabilidades y evaluación del estado del juego. Nuestra API está diseñada para desarrolladores que desean integrar análisis sofisticado de poker en sus aplicaciones.
URL Base
Autenticación
Todas las solicitudes a la API requieren autenticación con tu clave API. Incluye tu clave en los encabezados de la solicitud:
Endpoints
POST /api/v1/probabilities
Calcula las probabilidades de manos de poker para cartas dadas usando simulación de Monte Carlo.
Cuerpo de la Solicitud:
{
"cards": ["Ah", "Kh"]
}Respuesta:
{
"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 estadísticas avanzadas de poker incluyendo tasas de victoria contra múltiples oponentes y desgloses detallados de probabilidades de manos tanto para el jugador como para los oponentes.
Cuerpo de la Solicitud:
{
"cards": ["Kh", "Kc"],
"opponents": 3
}Respuesta:
{
"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 Interactiva
Prueba la API con esta calculadora interactiva de probabilidades de poker. Selecciona tus cartas y las cartas de la mesa para ver cálculos de probabilidades en tiempo real.
Calculadora de Probabilidades de Poker
Selecciona tus cartas de mano y las cartas comunitarias para calcular las probabilidades de ganar
Tus Cartas
Cartas Comunitarias
Demo Avanzada - Análisis de Tasa de Victoria
Prueba la API avanzada que calcula tasas de victoria contra múltiples oponentes y muestra desgloses detallados de probabilidades de manos tanto para ti como para tus oponentes.
Análisis Avanzado de Poker
Selecciona tus cartas y el número de oponentes para ver tasas de victoria y comparaciones de probabilidades
Tus Cartas
Cartas Comunitarias
Número de Oponentes
Convenciones de Nomenclatura de Cartas
Todas las cartas en la API usan un formato estandarizado de dos caracteres: Valor + Palo
Valores
As
Rey
Reina
Jota
Diez
Nueve a Dos
Palos
Corazones ♥
Diamantes ♦
Tréboles ♣
Picas ♠
Ejemplos
Formatos de Mensaje
Formato de Solicitud
Todas las solicitudes POST deben usar formato JSON con Content-Type: application/json
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
{
"parameter": "value"
}Formato de Respuesta
Todas las respuestas se devuelven en formato JSON:
{
"success": true,
"data": {
// Response data here
}
}Formato de Error
{
"success": false,
"error": {
"code": "INVALID_CARDS",
"message": "Invalid card format provided",
"details": "Card 'Xh' is not a valid card"
}
}Códigos de Error
| Código | Descripción |
|---|---|
INVALID_API_KEY |
La clave API falta o no es válida |
INVALID_CARDS |
Una o más cartas tienen un formato no válido |
DUPLICATE_CARDS |
La misma carta aparece varias veces |
RATE_LIMIT_EXCEEDED |
Demasiadas solicitudes en el período de tiempo |
INSUFFICIENT_CREDITS |
La cuenta no tiene suficientes créditos de API |
Ejemplos 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}`);
}Soporte
¿Necesitas ayuda con la API? Estamos aquí para asistirte:
- Correo electrónico: [email protected]