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
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/stations— Stromstationen
Die nächsten amtlichen Stromstationen mit Entfernung — zum Auswählen.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 106 Quellen.GET /v1/locks— Schleusen
3.396 Schleusen mit Abmessungen und Betriebsangaben.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. |