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/.

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/terrain-mesh/datasets — Phase 2a Single-Level-Tilesets, Multi-Level-LoD-Pyramide in Phase 2b).

Operation-IDs

Alle Endpoints haben explizite operation_id (statt FastAPI-Default-Hashes) — matched 1:1 mit den Doku-MD-Filenamen.

In Pipeline (nicht released)

• Auth-Layer (Phase 2, Q3 2026) — X-Lodapi-Key Header + Zitadel-OIDC. Wird im /openapi.json als securitySchemes ergänzt; Phase-1-Public-Endpoints bleiben unauth.
• 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

Vor-0.1.0-Vergangenheit

Die API existierte vor diesem Changelog informal — siehe Tagesprotokolle in 08_logs/daily/2026-04-* und 2026-05-*. Das Schema-Snapshot war bis 2026-05-14 nicht eingecheckt; rückwirkende Versionsangaben wären spekulativ.