Poker API Dokumentation
Umfassende Anleitung zur Integration der AI Poker Tools API
Überblick
Die AI Poker Tools API bietet programmatischen Zugang zu fortgeschrittenen Pokerberechnungen, Quotenanalysen und Spielstandbewertungen. Unsere API ist für Entwickler konzipiert, die anspruchsvolle Pokeranalysen in ihre Anwendungen integrieren möchten.
Basis-URL
Authentifizierung
Alle API-Anfragen erfordern eine Authentifizierung mit Ihrem API-Schlüssel. Fügen Sie Ihren Schlüssel in die Request-Header ein:
Endpoints
POST /api/v1/probabilities
Berechnen Sie Poker-Hand-Wahrscheinlichkeiten für gegebene Karten mittels Monte-Carlo-Simulation.
Request Body:
{
"cards": ["Ah", "Kh"]
}
Antwort:
{
"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
Berechnen Sie erweiterte Pokerstatistiken einschließlich Gewinnraten gegen mehrere Gegner und detaillierte Hand-Wahrscheinlichkeitsaufschlüsselungen für Spieler und Gegner.
Request Body:
{
"cards": ["Kh", "Kc"],
"opponents": 3
}
Antwort:
{
"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
}
}
}
Interaktive Demo
Testen Sie die API mit diesem interaktiven Poker-Quotenrechner. Wählen Sie Ihre Karten und Board-Karten aus, um Echtzeit-Wahrscheinlichkeitsberechnungen zu sehen.
Poker-Quotenrechner
Wählen Sie Ihre Hole Cards und Community Cards, um Gewinnwahrscheinlichkeiten zu berechnen
Ihre Karten
Gemeinschaftskarten
Erweiterte Demo - Gewinnratenanalyse
Testen Sie die erweiterte API, die Gewinnraten gegen mehrere Gegner berechnet und detaillierte Hand-Wahrscheinlichkeitsaufschlüsselungen für Sie und Ihre Gegner anzeigt.
Erweiterte Pokeranalyse
Wählen Sie Ihre Karten und die Anzahl der Gegner, um Gewinnraten und Wahrscheinlichkeitsvergleiche zu sehen
Ihre Karten
Gemeinschaftskarten
Anzahl der Gegner
Kartenbezeichnungskonventionen
Alle Karten in der API verwenden ein standardisiertes Zwei-Zeichen-Format: Rang + Farbe
Ränge
Ass
König
Dame
Bube
Zehn
Neun bis Zwei
Farben
Herz ♥
Karo ♦
Kreuz ♣
Pik ♠
Beispiele
Nachrichtenformate
Anfrageformat
Alle POST-Anfragen sollten das JSON-Format mit Content-Type: application/json verwenden
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
{
"parameter": "value"
}
Antwortformat
Alle Antworten werden im JSON-Format zurückgegeben:
{
"success": true,
"data": {
// Response data here
}
}
Fehlerformat
{
"success": false,
"error": {
"code": "INVALID_CARDS",
"message": "Invalid card format provided",
"details": "Card 'Xh' is not a valid card"
}
}
Fehlercodes
| Code | Beschreibung |
|---|---|
INVALID_API_KEY |
API-Schlüssel fehlt oder ist ungültig |
INVALID_CARDS |
Eine oder mehrere Karten haben ein ungültiges Format |
DUPLICATE_CARDS |
Dieselbe Karte erscheint mehrfach |
RATE_LIMIT_EXCEEDED |
Zu viele Anfragen im Zeitfenster |
INSUFFICIENT_CREDITS |
Konto hat nicht genügend API-Guthaben |
Codebeispiele
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}`);
}