Documentation de l'API Poker
Guide complet pour l'intégration avec l'API AI Poker Tools
Aperçu
L'API AI Poker Tools offre un accès programmatique à des calculs de poker avancés, à l'analyse des cotes et à l'évaluation de l'état du jeu. Notre API est conçue pour les développeurs souhaitant intégrer une analyse de poker sophistiquée dans leurs applications.
URL de base
Authentification
Toutes les requêtes API nécessitent une authentification avec votre clé API. Incluez votre clé dans les en-têtes de la requête :
Endpoints
POST /api/v1/probabilities
Calculez les probabilités des mains de poker pour des cartes données à l'aide d'une simulation Monte Carlo.
Corps de la requête :
{
"cards": ["Ah", "Kh"]
}Réponse :
{
"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
Calculez des statistiques poker avancées incluant les taux de victoire contre plusieurs adversaires et les répartitions détaillées des probabilités de mains pour le joueur et les adversaires.
Corps de la requête :
{
"cards": ["Kh", "Kc"],
"opponents": 3
}Réponse :
{
"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
}
}
}Démo interactive
Essayez l'API avec ce calculateur interactif de cotes poker. Sélectionnez vos cartes et les cartes du board pour voir les calculs de probabilités en temps réel.
Calculateur de cotes poker
Sélectionnez vos cartes fermées et les cartes communes pour calculer les probabilités de gain
Vos cartes
Cartes communes
Démo avancée - Analyse du taux de victoire
Essayez l'API avancée qui calcule les taux de victoire contre plusieurs adversaires et affiche les répartitions détaillées des probabilités de mains pour vous et vos adversaires.
Analyse poker avancée
Sélectionnez vos cartes et le nombre d'adversaires pour voir les taux de victoire et les comparaisons de probabilités
Vos cartes
Cartes communes
Nombre d'adversaires
Conventions de notation des cartes
Toutes les cartes dans l'API utilisent un format standardisé à deux caractères : Rang + Couleur
Rangs
As
Roi
Dame
Valet
Dix
Neuf à Deux
Couleurs
Cœur ♥
Carreau ♦
Trèfle ♣
Pique ♠
Exemples
Formats des messages
Format de la requête
Toutes les requêtes POST doivent utiliser le format JSON avec Content-Type: application/json
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
{
"parameter": "value"
}Format de la réponse
Toutes les réponses sont renvoyées au format JSON :
{
"success": true,
"data": {
// Response data here
}
}Format d'erreur
{
"success": false,
"error": {
"code": "INVALID_CARDS",
"message": "Invalid card format provided",
"details": "Card 'Xh' is not a valid card"
}
}Codes d'erreur
| Code | Description |
|---|---|
INVALID_API_KEY |
La clé API est manquante ou invalide |
INVALID_CARDS |
Une ou plusieurs cartes ont un format invalide |
DUPLICATE_CARDS |
La même carte apparaît plusieurs fois |
RATE_LIMIT_EXCEEDED |
Trop de requêtes dans l'intervalle de temps |
INSUFFICIENT_CREDITS |
Le compte n'a pas suffisamment de crédits API |
Exemples de code
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}`);
}