Fehler und Limits
Das Format einer Fehlermeldung, alle Fehlercodes, das Ratenlimit pro Schlüssel und weitere Limits.
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#
| HTTP | Code | Bedeutung |
|---|---|---|
| 400 | E_VALIDATION | Ungültige Eingabe, zum Beispiel ein falsches limit, ein ungültiges Datum oder eine unbekannte customer_id. message sagt, was. |
| 401 | E_AUTH | Schlüssel fehlt, ist ungültig, widerrufen oder abgelaufen. |
| 403 | E_SCOPE | Dem Schlüssel fehlt die nötige Berechtigung. |
| 404 | E_UNKNOWN | Unbekannter Pfad. |
| 404 | E_NOT_FOUND | Die Sendung existiert nicht (oder gehört nicht zu diesem Unternehmen). |
| 405 | E_METHOD | Falsche Methode; der Header Allow nennt die zulässigen. |
| 413 | E_TOO_LARGE | Der Body ist größer als 64 KB. |
| 429 | E_RATE | Zu viele Aufrufe; siehe unten. |
| 500 | E_SERVER | Vorü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-limitin jeder Antwort nennt das Limit Ihres Schlüssels. - Bei Überschreitung erhalten Sie
429mitE_RATEund dem HeaderRetry-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
429beantwortet.
Weitere Limits#
| Limit | Wert |
|---|---|
| Größe des Body | 64 KB |
limit pro Seite | 1 bis 200, standardmäßig 50 |
| Offene Transportanfragen pro Kunde | 30 |
| Aktive Schlüssel pro Unternehmen | 20 |
| Webhooks pro Unternehmen | 10 |
| Antwortzeit Ihrer Webhook-Adresse | 10 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.