Zum Inhalt springen
craftdexDocs

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." } }
HTTPCodeBedeutung
400token_in_urlDer Schlüssel steht in der Adresse. Bitte nur im Kopf Authorization senden.
401unauthorizedSchlüssel fehlt oder ist ungültig.
401token_expiredSchlüssel ist abgelaufen.
401token_revokedSchlüssel wurde widerrufen.
403ip_not_allowedDer Schlüssel ist auf andere IP-Adressen beschränkt.
404not_foundEndpunkt oder Datei gibt es nicht (auch bei fremden Dateien und bei Dateien aus Bereichen, die der Schlüssel nicht freigibt).
429rate_limitedZu viele Anfragen, siehe unten. Der Kopf Retry-After nennt die Wartezeit in Sekunden.
500server_errorFehler bei uns. Bitte später erneut versuchen.
503disabledDie Schnittstelle ist vorübergehend abgeschaltet.

Grenzen

AbrufGrenze
export und export.jsonzusammen höchstens 5 je 15 Minuten und Betrieb, einschließlich der Exporte in der Anwendung
files600 je Minute und Schlüssel
info60 je Minute und Schlüssel
ungültige Schlüssel10 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 429 die Zeit aus Retry-After abwarten.
  • Bei 500, 502, 503 und Verbindungsabbrüchen mit wachsender Pause erneut versuchen, etwa nach 2, 4 und 8 Sekunden.
  • Bei 401 nicht wiederholen: Der Schlüssel muss erneuert werden.
  • Bei 403 ip_not_allowed nicht wiederholen: Die Anfrage kommt von einer Adresse, die nicht freigegeben ist.

Auf dieser Seite