Fehler und Limits

Statuscodes

Code	Bedeutung	Was tun
`200`	Erfolg	–
`401`	Schlüssel fehlt, ist unbekannt, widerrufen oder abgelaufen	Header `X-API-KEY` prüfen, ggf. neuen Schlüssel erstellen
`403`	Schlüssel gehört zu einem anderen Mandanten oder hat die Berechtigung nicht	Tenant-ID im Pfad und Berechtigungen des Schlüssels prüfen
`405`	Methode nicht erlaubt – die API ist nur lesend	Nur `GET` verwenden
`422`	Ungültiger Parameter (z. B. Datum im falschen Format, `limit` über 1000)	Parameter laut Fehlermeldung korrigieren
`429`	Rate Limit erreicht	Wartezeit aus Header `Retry-After` (Sekunden) abwarten

Fehler kommen als JSON mit einem Feld detail:

{ "detail": "Invalid or missing API key" }

Rate Limit

Jeder API-Schlüssel darf 120 Anfragen pro Stunde stellen (festes Stundenfenster). Danach antwortet die API mit 429 und dem Header Retry-After, der angibt, wie viele Sekunden bis zum nächsten Fenster bleiben. Für einen täglichen Abgleich reichen ein bis zwei Aufrufe pro Tag; mit from_date lässt sich auf neue Buchungen seit dem letzten Abruf einschränken.

Erste Schritte

API-Referenz

Statuscodes

Rate Limit

​Statuscodes

​Rate Limit

Statuscodes

Rate Limit