---
title: API-Changelog
summary: Semver-getrackt. Phase 1 ist pre-1.0 — minor-Bumps sind bruchtolerant.
---# API-Changelog

Versions-Anzeige in `info.version` der [OpenAPI](../openapi/openapi.json). 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

| 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/daily/2026-04-*` und `2026-05-*`. Das Schema-Snapshot war bis 2026-05-14 nicht eingecheckt; rückwirkende Versionsangaben wären spekulativ.