API-Dokumentation

Die LageLuchs-API liefert LuchsScore, Standortklasse (A–D), Trend und Dimensions-Scores je Region als JSON. Der Zugang erfordert einen API-Key (Premium-Feature), den du in deinem Konto erstellst.

Authentifizierung

Sende deinen API-Key in jedem Request — wahlweise als Bearer-Token oder im x-api-key-Header:

Authorization: Bearer ll_live_…
x-api-key: ll_live_…

Keys verwaltest du unter „API-Zugang“ in deinemKonto.

Endpunkte

GET /api/v1/regions/{ags oder slug}

Gibt Score, Standortklasse, Trend, Dimensions-Scores, Datenstand und Vertrauensniveau einer Region zurück.

Beispiel (curl)

curl -H "Authorization: Bearer ll_live_…" https://lageluchs.de/api/v1/regions/05315000

Rate-Limits

Jeder Key ist auf 60 Anfragen pro Minute begrenzt. Bei Überschreitung antwortet die API mit HTTP 429 und dem Header Retry-After (Sekunden bis zur nächsten erlaubten Anfrage).

Antwort-Header: X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After.

Fehlercodes: 401 (kein Key), 403 (kein Premium), 404 (Region nicht gefunden), 429 (Rate-Limit). Alle Fehler nutzen dasselbe JSON-Format:

{ "error": { "code": "...", "message": "..." } }

OpenAPI-Spezifikation

Die maschinenlesbare Spezifikation findest du unter/api/v1/openapi.json.