API
Der Atlas als Daten
Kostenloser, schreibgeschützter JSON-Zugriff auf die gecachte Datenbank der Website – dieselben strukturierten Daten, die die Seiten anzeigen, mit denselben Vertrauenslabels und Vorbehalten. Kein API-Schlüssel erforderlich für private Nutzung und Forschung in vernünftigem Umfang.
| Endpunkt | Rückgaben |
|---|---|
/api/v1/regions | Die 8 Tauchregionen |
/api/v1/countries | Länderführer: Saisons, Kostenbereiche, Wassertemperaturen |
/api/v1/destinations?country=®ion= | Reiseziele mit besten Monaten und typischen Kosten |
/api/v1/destination/{slug} | Ein Reiseziel inkl. Monatsübersicht, Tauchplätze und Tierarten |
/api/v1/sites?destination=&country=&type=&difficulty=&month= | Tauchplatz-Finder – strukturierte Einträge |
/api/v1/site/{slug} | Ein Tauchplatz, vollständiger Eintrag inkl. Tierarten |
/api/v1/species?group= | Meeresfauna- und -flora-Katalog |
/api/v1/species/{slug} | Eine Tierart inkl. Sichtungsorten und -zeiten |
/api/v1/wrecks?country= | Wrack-Datenbank |
/api/v1/liveaboards?region= | Liveaboard-Verzeichnis |
/api/v1/operators?destination= | Tauchbasen und Resorts |
/api/v1/parks | Meeresschutzgebiete |
/api/v1/chambers | Druckkammer-Planungsreferenz (KEIN Notfalldatensatz) |
/api/v1/season/{month} | Reiseziele in der Saison für Monat 1–12 |
Beispiel
curl https://scuba.guide/api/v1/season/2 curl "https://scuba.guide/api/v1/sites?type=wreck&difficulty=beginner" curl https://scuba.guide/api/v1/species/whale-shark
Der Vertrag
Jede Antwort ist ein Envelope: {"data": ..., "meta": {...}}, wobei meta Zählungen, Attribution, einen Zeitstempel und den Haftungshinweis enthält. Werte sind Bereiche und Labels, wie auf der Website angezeigt; fehlend bedeutet noch nicht verifiziert, nie null. Cache ca. 5 Minuten; aus unserer Datenbank ausgeliefert, ohne Live-Upstream-Anfragen. Attribution erforderlich: „Data: Scuba Guide" mit Link. Kommerzielle Lizenzierung: über die Kontaktseite.