Entwickler

Fehler-Codes.

Wir folgen HTTP-Standards. Alle Fehler-Responses haben eine konsistente JSON-Struktur.

Response-Format

{
  "error": {
    "code": "validation_error",
    "message": "EPSG code 99999 is not supported.",
    "request_id": "req_aT3Dd9_4kL",
    "docs": "https://geospatial.gddc-sh.de/docs/concepts/coordinate-systems"
  }
}

Codes

HTTP	code	Bedeutung	Lösung
400	invalid_request	Body fehlerhaft, Felder unzulässig	Felder validieren, Beispiel checken
401	unauthorized	Token fehlt oder abgelaufen	API-Key erneuern, Header prüfen
403	forbidden	Token hat den Scope nicht	Service-Account-Scopes erweitern
404	not_found	Resource existiert nicht (oder gehört nicht dir)	ID prüfen, Account-Trennung beachten
409	conflict	Resource existiert bereits	Ggfs. update statt create
413	payload_too_large	Upload > 25 GB pro Batch	Chunken (CLI macht das automatisch)
422	validation_error	Daten fachlich falsch (z.B. EPSG-Code unbekannt)	Konzepte-Doku prüfen
429	rate_limited	Rate-Limit überschritten	Backoff, Retry-After-Header beachten
500	internal_error	Fehler bei uns	Sentry-ID an support melden
502	upstream_error	Worker oder Storage temporär down	Status.gddc-sh.de prüfen, retry
503	maintenance	Geplante Wartung	Status-Seite, Wartungs-Fenster prüfen

Request-IDs

Jeder Response hat einen Header X-Request-Id. Bei Support-Tickets immer mitschicken — wir können dann die exakte Request-Trace im Log finden.