API-Anfragen & Kontingent verstehen

Ihr Abonnement-Tarif enthält ein monatliches Anfragekontingent. Auf dieser Seite wird genau erklärt, was als Anfrage zählt, welche Endpunkte kostenlos sind und was passiert, wenn Sie Ihr Limit erreichen.

Was ist 1 Anfrage?

1 Anfrage = 1 Aufruf eines abrechnungspflichtigen API-Endpunkts, unabhängig von der Antwort.

Jeder erfolgreiche Aufruf eines abrechnungspflichtigen Endpunkts zählt als genau eine Anfrage gegen Ihr Kontingent. Antwortgröße, Anzahl der zurückgegebenen Einträge, Query-Parameter oder HTTP-Status haben keinen Einfluss auf die Zählung — ein Aufruf, der 1.000 Fixtures zurückgibt, und ein Aufruf, der 0 Fixtures zurückgibt, verbrauchen beide exakt 1 Anfrage.

Anfragen werden pro Abonnement gezählt, sodass alle mit Ihrem API-Schlüssel getätigten Aufrufe demselben Kontingent zugeschlagen werden.

Welche Endpunkte zählen?

Abrechnungspflichtige Endpunkte (zählen zu Ihrem Kontingent)

Jeder Aufruf dieser Endpunkte verbraucht 1 Anfrage:

/v4/players
/v4/settlements
/v4/fixtures
/v4/fixture
/v4/odds-by-tournaments
/v4/languages
/v4/sports
/v4/bookmakers
/v4/markets
/v4/tournaments
/v4/participants
/v4/scores
/v4/odds

Kostenlose Endpunkte (zählen NICHT zu Ihrem Kontingent)

/v4/historical-odds — immer kostenlos. Aufrufe erhöhen den Anfragenzähler nie.

Nicht gemessene Endpunkte (zählen NICHT und werden nie blockiert)

/v4/account — immer erreichbar, auch nachdem Ihr Kontingent aufgebraucht ist. So können Sie jederzeit den Status Ihres Abonnements und das verbleibende Kontingent prüfen.

Wann wird eine Anfrage gezählt?

Eine Anfrage wird gezählt, nachdem der Endpunkt die Verarbeitung abgeschlossen hat, unabhängig davon, ob die Antwort erfolgreich war oder einen Fehler zurückgegeben hat. Dazu gehören:

200 OK — erfolgreiche Antworten
4xx — Client-Fehler (z. B. ungültige Parameter, Ressource nicht gefunden)
5xx — Server-Fehler

Hinweis

Anfragen, die vor Erreichen des Endpunkts abgelehnt werden — z. B. weil Ihr API-Schlüssel ungültig ist oder Ihr Kontingent bereits aufgebraucht ist — werden nicht gezählt.

Ihr Limit erreichen

Sobald Ihre kumulierte Anfragenzahl den Wert request_limit Ihres Tarifs erreicht, gibt jeder weitere Aufruf eines abrechnungspflichtigen oder kostenlosen Endpunkts (außer /v4/account) sofort Folgendes zurück:

HTTP/1.1 429 Too Many Requests

{
  "message": "Request limit exceeded",
  "details": "You have exceeded your request limit of X requests.",
  "code": "REQUEST_LIMIT_EXCEEDED"
}

Sie können /v4/account weiterhin jederzeit aufrufen, um Ihr Abonnement, die aktuelle Nutzung und den Zeitpunkt des Kontingent-Resets einzusehen.

Nutzung prüfen

Rufen Sie jederzeit GET /v4/account auf. Die Antwort enthält für Ihr aktives Abonnement:

request_limit — das Kontingent Ihres Tarifs
request_count — wie viele abrechnungspflichtige Anfragen Sie im aktuellen Zeitraum verbraucht haben

Tipps zur Reduzierung des Anfragenverbrauchs

Antworten clientseitig cachen, wenn sich die zugrundeliegenden Daten selten ändern (z. B. /v4/sports, /v4/bookmakers, /v4/markets, /v4/languages).
Wenn möglich bündeln — verwenden Sie /v4/fixtures mit Filtern statt vieler einzelner Fixture-Aufrufe, wenn Sie mehrere Fixtures auf einmal benötigen.
Verantwortungsvoll pollen — jeder Poll eines abrechnungspflichtigen Endpunkts ist 1 Anfrage; stimmen Sie Ihr Poll-Intervall darauf ab, wie oft sich die Daten tatsächlich ändern.

Vorherige SeiteOverview

Nächste SeiteGET account