Fehler und Grenzen
Fehlercodes der Schnittstelle und wie viele Anfragen erlaubt sind.
Fehler
Fehler kommen immer als JSON:
{ "error": { "code": "token_expired", "message": "Dieser API-Schlüssel ist abgelaufen." } }| HTTP | Code | Bedeutung |
|---|---|---|
| 400 | token_in_url | Der Schlüssel steht in der Adresse. Bitte nur im Kopf Authorization senden. |
| 401 | unauthorized | Schlüssel fehlt oder ist ungültig. |
| 401 | token_expired | Schlüssel ist abgelaufen. |
| 401 | token_revoked | Schlüssel wurde widerrufen. |
| 403 | ip_not_allowed | Der Schlüssel ist auf andere IP-Adressen beschränkt. |
| 404 | not_found | Endpunkt oder Datei gibt es nicht (auch bei fremden Dateien und bei Dateien aus Bereichen, die der Schlüssel nicht freigibt). |
| 429 | rate_limited | Zu viele Anfragen, siehe unten. Der Kopf Retry-After nennt die Wartezeit in Sekunden. |
| 500 | server_error | Fehler bei uns. Bitte später erneut versuchen. |
| 503 | disabled | Die Schnittstelle ist vorübergehend abgeschaltet. |
Grenzen
| Abruf | Grenze |
|---|---|
export und export.json | zusammen höchstens 5 je 15 Minuten und Betrieb, einschließlich der Exporte in der Anwendung |
files | 600 je Minute und Schlüssel |
info | 60 je Minute und Schlüssel |
| ungültige Schlüssel | 10 je Minute und IP-Adresse, danach 429 für eine Minute |
Eine Anfrage darf höchstens 5 Minuten dauern. Reicht das für die ZIP-Datei nicht, nutzen Sie export.json mit Einzeldateien.
Wiederholen
- Bei
429die Zeit ausRetry-Afterabwarten. - Bei
500,502,503und Verbindungsabbrüchen mit wachsender Pause erneut versuchen, etwa nach 2, 4 und 8 Sekunden. - Bei
401nicht wiederholen: Der Schlüssel muss erneuert werden. - Bei
403 ip_not_allowednicht wiederholen: Die Anfrage kommt von einer Adresse, die nicht freigegeben ist.