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.

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

• GET /v1/tides — Gezeiten
  Wasserstand, Hoch- und Niedrigwasser an jedem Punkt der Weltmeere.
• GET /v1/currents — Gezeitenstrom
  Set & Drift — Richtung und Geschwindigkeit des Gezeitenstroms am Punkt.
• GET /v1/currents-field — Strömungsfeld
  Vektorfeld über ein Gebiet — für Karten-Overlays.
• GET /v1/levels — Pegel & Messstationen
  Gemessene Wasserstände, Wellen und Wassertemperatur aus amtlichen Netzen.
• GET /v1/warnings — Reviermeldungen
  Amtliche Bekanntmachungen für die Schifffahrt aus 36 Quellen.
• GET /v1/locks — Schleusen
  3.396 Schleusen mit Abmessungen und Betriebsangaben.
• GET /v1/shelter — Hafenschutz
  Windschutz für 22.669 Marinas — aus welcher Richtung ein Hafen gedeckt ist.
• GET /v1/me — Schlüssel prüfen
  Plan, Scopes und Kontingent-Stand des eigenen Schlüssels.

Status

GET /v1/status	Öffentlicher Modul-Status, ohne Schlüssel abrufbar.
GET /v1/levels/status	Pegel-Messnetze: Abdeckung und Frische je Netz.
GET /v1/warnings/status	Meldungsquellen: Ertrag und Frische je Quelle.
GET /v1/locks/status	Schleusen je Land.
GET /v1/shelter/status	Hafenschutz: Abdeckung.