Fehler und Limits

Das Format einer Fehlermeldung, alle Fehlercodes, das Ratenlimit pro Schlüssel und weitere Limits.

Zuletzt aktualisiert: Hilfe nötig? Support kontaktieren

Das Fehlerformat#

Jeder Fehler hat dieselbe Form:

{
  "error": {"code": "E_SCOPE", "message": "This API key does not have the required scope."},
  "request_id": "6f1c2a3e-0000-4000-8000-000000000000"
}

Verwenden Sie in Ihrem Programm code; message ist eine Erläuterung für Menschen und kann sich ändern. Geben Sie die request_id (auch im Header x-request-id) an, wenn Sie den Support kontaktieren.

Fehlercodes#

HTTPCodeBedeutung
400E_VALIDATIONUngültige Eingabe, zum Beispiel ein falsches limit, ein ungültiges Datum oder eine unbekannte customer_id. message sagt, was.
401E_AUTHSchlüssel fehlt, ist ungültig, widerrufen oder abgelaufen.
403E_SCOPEDem Schlüssel fehlt die nötige Berechtigung.
404E_UNKNOWNUnbekannter Pfad.
404E_NOT_FOUNDDie Sendung existiert nicht (oder gehört nicht zu diesem Unternehmen).
405E_METHODFalsche Methode; der Header Allow nennt die zulässigen.
413E_TOO_LARGEDer Body ist größer als 64 KB.
429E_RATEZu viele Aufrufe; siehe unten.
500E_SERVERVorübergehender Fehler auf dem Server. Versuchen Sie es später erneut.

Ratenlimit#

  • Jeder Schlüssel hat ein Limit pro Minute, standardmäßig 60 Aufrufe pro Minute, in festen Fenstern von einer Minute.
  • Der Header x-ratelimit-limit in jeder Antwort nennt das Limit Ihres Schlüssels.
  • Bei Überschreitung erhalten Sie 429 mit E_RATE und dem Header Retry-After: 60. Warten Sie dann und versuchen Sie es erneut.
  • Zu viele Aufrufe mit einem ungültigen Schlüssel von derselben Adresse werden ebenfalls eine Zeit lang mit 429 beantwortet.

Weitere Limits#

LimitWert
Größe des Body64 KB
limit pro Seite1 bis 200, standardmäßig 50
Offene Transportanfragen pro Kunde30
Aktive Schlüssel pro Unternehmen20
Webhooks pro Unternehmen10
Antwortzeit Ihrer Webhook-Adresse10 Sekunden

Protokoll#

INTEGALL speichert pro Aufruf nur die Operation, den Status, die Dauer und das Präfix des Schlüssels, nie den Schlüssel selbst oder den Inhalt. Das Aufrufprotokoll wird nach 90 Tagen gelöscht.