Neptun·

API-Referenz

Neptun ist eine REST-API für Gezeiten, Gezeitenströme und europäische Küstendaten. Alle Antworten sind JSON, alle Endpunkte read-only via GET.

Basis-URL & Authentifizierung

Basis-URL: https://neptun.marine-api.com/v1

Jede Anfrage benötigt einen API-Schlüssel (mapi_…) im Authorization-Header (empfohlen) oder als ?key=-Parameter:

curl -H "Authorization: Bearer mapi_DEIN_SCHLUESSEL" \
  "https://neptun.marine-api.com/v1/tides?lat=54.32&lon=13.10"

Kontingente

Kontingente gelten pro Kalendermonat (UTC). Jede Antwort enthält ein quota-Objekt. Bei erschöpftem Kontingent antwortet die API mit 429; zusätzlich gilt ein Minuten-Limit (Standard 120/min), das ebenfalls 429 mit Retry-After liefert. Im Free-Plan gilt außerdem eine Tagesgrenze von 100 Aufrufen je Kalendertag (UTC), je Schlüssel und je Anschluss; danach antwortet die API mit 429 und Retry-After bis 00:00 UTC. /v1/me zeigt den Verbrauch (used_month, bei Free auch used_today) und zählt selbst nicht mit.

Attribution (Pflicht)

Jede Antwort enthält ein attribution-Feld. Die Quellenangabe ist gemäß den Lizenzen der Datengeber mitzuführen, wenn Sie die Daten darstellen oder weiterverarbeiten. Modellwerte — nicht für die Navigation.

Welche Netze und Länder sind abgedeckt?

Beispiel-Clients (Python, Node)

Endpunkte

Status

GET /v1/statusÖffentlicher Modul-Status, ohne Schlüssel abrufbar.
GET /v1/levels/statusPegel-Messnetze: Abdeckung und Frische je Netz.
GET /v1/warnings/statusMeldungsquellen: Ertrag und Frische je Quelle.
GET /v1/locks/statusSchleusen je Land.