API-Changelog
Versions-Anzeige in info.version der OpenAPI. Phase-1-Pre-1.0-Konvention: minor-Bumps können bruchhaft sein, bis das /v1/-Vertrag mit 1.0.0 stabil wird.
Ab 1.0.0: strict semver. Breaking changes nur in /v2/.
Feature-Gating nach Tarif — Oktober 2026 (T-0077)
Die eigentlichen Daten-Endpoints sind nach Tarif freigeschaltet (Decision 2026-10-08-01). Ohne Key 401, mit zu kleinem Tarif 403, beides application/ mit required_tier. Trial-Keys haben Pro-Umfang.
| Endpoint | Mindest-Tarif |
|---|---|
GET /, GET / | Hobby |
GET / | Hobby |
GET / | Pro |
GET / | Pro |
Alle anderen /v1/-Endpoints bleiben ohne Key nutzbar. OpenAPI: securitySchemes.ApiKeyAuth (Header X-API-Key), security nur auf den gesperrten Operationen, Mindest-Tarif als x-lodapi-min-tier. Details: Limits und Zugang.
0.1.0 — 2026-05-14
Erstes dokumentiertes Schema. Stand der API am Tag der Doku-Architektur-Entscheidung (ADR-0013).
Endpoints (13)
GET /healthz GET /v1/ datasets GET /v1/ tilesets GET /v1/ tilesets/ {tileset_id} GET /v1/ tilesets/ {tileset_id}/ tileset.json GET /v1/ buildings GET /v1/ buildings/ {gmlid} GET /v1/ buildings/ 3d.glb GET /v1/ terrain/ elevation GET /v1/ terrain/ datasets GET /v1/ terrain/ profile GET /v1/ terrain-mesh/ datasets POST /v1/ admin/ datasets
Stabilität
- 12 Endpoints sind
stable. - 1 Endpoint
beta(/v1/— Phase 2a Single-Level-Tilesets, Multi-Level-LoD-Pyramide in Phase 2b).terrain-mesh/ datasets
Operation-IDs
Alle Endpoints haben explizite operation_id (statt FastAPI-Default-Hashes) — matched 1:1 mit den Doku-MD-Filenamen.
In Pipeline (nicht released)
- OIDC-Login (Zitadel) für Konto-Funktionen. Der API-Zugang selbst läuft über
X-API-Key(siehe Feature-Gating oben). - OGC-API-Features-Layer (Phase 2) —
/ogcapi/über ldproxy-Sidecar. Eigene OpenAPI, eigener Spec-Output.* - Buildings + Terrain Coverage — kontinuierliche BL-Erweiterung, kein API-Schema-Change.
Versions-Strategie
| Pre-1.0 (Phase 1) | Post-1.0 (Phase 2+) |
|---|---|
| Minor-Bumps können bruchhaft sein | Breaking changes nur im /v2/-Pfad |
| Doku-Drift-Check verhindert versehentliche Breaking | Doku-Drift-Check + Schema-Test pro PR |
Pfad-Versionierung /v1/ fest | /v2/ parallel ab Phase-2-Start |
Vor-0.1.0-Vergangenheit
Die API existierte vor diesem Changelog informal — siehe Tagesprotokolle in 08_logs/ und 2026-05-*. Das Schema-Snapshot war bis 2026-05-14 nicht eingecheckt; rückwirkende Versionsangaben wären spekulativ.