Fehlerantworten in der Data API - Data API

Die Data API liefert Fehler im RFC-7807-Format (application/problem+json). Jede Fehlerantwort enthält einen konsistenten Satz von Feldern, sodass du das Problem programmatisch erkennen, die Details protokollieren und entscheiden kannst, wie du den Request wiederholst oder korrigierst.

Problem-JSON-Format

Jeder Fehlerantwort-Body enthält diese Felder:

Feld	Typ	Beschreibung
`type`	string	Eine URI, die den Fehlertyp identifiziert. Standardmäßig `about:blank` für generische Fehler.
`title`	string	Eine kurze, menschenlesbare Zusammenfassung des Fehlertyps.
`status`	integer	Der HTTP-Statuscode.
`detail`	string	Eine detaillierte, menschenlesbare Erklärung dieses konkreten Vorfalls.
`instance`	string	Der Request-Pfad, der den Fehler ausgelöst hat.

Beispiel-Fehlerantwort für einen ungültigen API-Key:

{
  "type": "about:blank",
  "title": "Forbidden",
  "status": 403,
  "detail": "Invalid API key",
  "instance": "/v1/property/properties"
}

Statuscodes

Status	Bedeutung	Was zu tun ist
400	Erforderlicher Filter fehlt	Prüfe die Endpunkt-Dokumentation auf erforderliche Query-Parameter und ergänze sie im Request.
401	API-Key fehlt	Sende den `X-API-Key`-Header bei jedem Request.
403	Key abgelehnt oder Zugriffsstufe fehlt	Der Key ist unbekannt oder deaktiviert, oder er hat keine Berechtigung für diesen Endpunkt oder diese Tabelle, oder er ist auf Properties eingeschränkt und die Tabelle hat keine `property_id`-Spalte. Prüfe das Feld `detail`. Kontaktiere den Trassets-Support, um deine Zugriffsstufe zu ändern.
404	Unbekannter Endpunkt	Überprüfe den URL-Pfad sowie den Category- oder Tabellennamen.
409	Snapshot geändert	Die Tabelle wurde während deiner Pagination neu synchronisiert. Starte neu ab der ersten Seite ohne `cursor`. Siehe Pagination.
422	Validierungsfehler	Ein Query-Parameter hat die Validierung nicht bestanden. Prüfe das `detail`-Feld für den genauen Parameter und die Einschränkung.
429	Rate-Limit überschritten	Du hast das Limit von 2.500 Requests pro Stunde deines API-Keys überschritten. Warte ab und versuche es erneut, nachdem das aktuelle Zeitfenster zurückgesetzt wurde.
500	Interner Fehler	Ein serverseitiger Fehler ist aufgetreten. Wiederhole den Request nach einer kurzen Verzögerung und kontaktiere den Support, falls das Problem weiterhin besteht.

Ein 401 bedeutet nur, dass der X-API-Key-Header fehlt. Ein unbekannter oder deaktivierter Key liefert 403, ebenso ein gültiger Key ohne die erforderliche Zugriffsstufe. Das Feld detail zeigt, welcher Fall vorliegt.