REST API · v1

API-Referenz.

OpenAPI 3.1, JSON-only, REST-konform. Base-URL:

https://api.geospatial.gddc-sh.de/v1

Auth

Alle Endpunkte erwarten einen Bearer-Token im Authorization-Header. Token-Format: gsk_live_…. Mehr im Auth-Flow.

Authorization: Bearer gsk_live_aT3Dd9_xxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
Accept: application/json

OpenAPI-Spec

Volle Spec als YAML/JSON:

Resources

Projects

Top-Level Container für Bahn/Bau/KRITIS-Erfassungen

Flights

Drohnen-Flüge mit Captures, RTK, Status

Pointclouds

Punktwolken nach Verarbeitung

Orthomosaics

Orthofotos / GeoTIFF

Soll-Models

BIM/CAD-Modelle als Soll-Schicht

Analyses

Soll-Ist, Volumen, Lichtraum, Anomalien

Reports

DIN-Reports (PDF/GAEB)

Tiles

Read-only Tile-Endpoints (XYZ, 3D-Tiles)

Events

Webhook-Events query/replay

SDKs

@gddc/geospatial (JS/TS, npm)
gddc-geospatial (Python, PyPI)
@gddc/geospatial-cli (CLI)

Inoffizielle Wrapper für Go, Rust, Java auf Anfrage — wir helfen gern beim Bauen.

Versionierung

Wir versionieren über die URL (/v1/…). Breaking Changes → neue Major-Version. Mindest-Support-Zeit für eine Version: 18 Monate ab Release der nächsten.