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

https://www.aipokertools.com

Authentifizierung

Alle API-Anfragen erfordern eine Authentifizierung mit Ihrem API-Schlüssel. Fügen Sie Ihren Schlüssel in die Request-Header ein:

Authorization: Bearer YOUR_API_KEY

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

Wählen Sie mindestens Ihre zwei Hole Cards aus, um die Quoten zu berechnen

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

3 Gegner
Wählen Sie Ihre zwei Hole Cards und legen Sie die Gegneranzahl fest, um Gewinnraten zu analysieren

Kartenbezeichnungskonventionen

Alle Karten in der API verwenden ein standardisiertes Zwei-Zeichen-Format: Rang + Farbe

Ränge

A
Ass
K
König
Q
Dame
J
Bube
T
Zehn
9-2
Neun bis Zwei

Farben

h
Herz ♥
d
Karo ♦
c
Kreuz ♣
s
Pik ♠

Beispiele

Ah = Herz-Ass Kd = Karo-König Qc = Kreuz-Dame Js = Pik-Bube Th = Herz-Zehn 2s = Pik-Zwei

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}`);
}

Support

Brauchen Sie Hilfe mit der API? Wir helfen Ihnen gerne:

Inhaltsverzeichnis

Karte auswählen

Rang

Farbe