Headers

Alle Antworten werden im JSON-Format zurückgegeben. Dies wird durch Senden der Kopfzeile "Content-Type" angegeben.

Response example:

HTTP/1.1 200 OK
Content-Type: application/json
{
    "success": "true",
}

Status Codes

Alle fehlgeschlagenen Antworten enthalten eine JSON-Antwort mit "error" auf true und einer Fehlermeldung.

Example response of a failed request:

HTTP/1.1 400 Bad request
Content-Type: application/json
{
    "error": "true",
    "message": "Some error message", 
}

Rate Limits

Allen Aufrufen innerhalb der Web-API wird eine bestimmte Anzahl von Anfragen pro Aktualisierungszeitraum zugewiesen.

Je nach Endpunkt, den du zu erreichen versuchst, ist eine bestimmte Anzahl von Anfragen pro Aktualisierungszeitraum zulässig. Sobald dieser Schwellenwert erreicht ist, geben wir eine Antwort mit dem Statuscode 429 zurück.

Jede API-Antwort enthält X-RateLimit-Header, die dich über dein aktuelles Ratenlimit informieren.

Example response:

HTTP/1.1 200 OK
Content-Type: application/json
X-RateLimit-Limit: 180
X-RateLimit-Remaining: 179
X-RateLimit-Reset: 60
{
  "foo": "bar"
}

Wenn das Limit erreicht ist, kannst du für die Dauer des Aktualisierungszeitraums keine Anfragen mehr an diesen Endpunkt stellen.

Standardmäßig kannst du mindestens 120 Anfragen pro Minute stellen. Dies entspricht 2 Anfragen pro Sekunde.