API
L'atlas comme base de données
JSON gratuit en lecture seule sur la base de données mise en cache du site : les mêmes données structurées qu'affichent les pages, avec les mêmes indicateurs de fiabilité et réserves. Aucune clé requise pour un usage personnel et de recherche raisonnable.
| Point d'accès | Retours |
|---|---|
/api/v1/regions | Les 8 régions de plongée |
/api/v1/countries | Guides par pays : saisons, fourchettes de coûts, températures de l'eau |
/api/v1/destinations?country=®ion= | Destinations avec les meilleurs mois et coûts typiques |
/api/v1/destination/{slug} | Une destination avec le bloc mois par mois, ses sites et ses espèces |
/api/v1/sites?destination=&country=&type=&difficulty=&month= | Moteur de recherche de sites de plongée : données structurées |
/api/v1/site/{slug} | Un site de plongée, fiche complète avec espèces |
/api/v1/species?group= | Catalogue des espèces marines |
/api/v1/species/{slug} | Une espèce avec lieux et périodes d'observation |
/api/v1/wrecks?country= | Base de données d'épaves |
/api/v1/liveaboards?region= | Répertoire des liveaboards |
/api/v1/operators?destination= | Centres et resorts de plongée |
/api/v1/parks | Zones marines protégées |
/api/v1/chambers | Référence de planification hyperbare (PAS des données d'urgence) |
/api/v1/season/{month} | Destinations en saison pour le mois 1–12 |
Exemple
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
Le contrat
Chaque réponse est une enveloppe, {"data": ..., "meta": {...}}, où meta contient les comptages, l'attribution, un horodatage et la clause de non-responsabilité. Les valeurs sont des fourchettes et des indicateurs tels qu'affichés sur le site ; manquant signifie pas encore vérifié, jamais zéro. Mise en cache environ 5 minutes ; servi depuis notre base de données sans appel amont en direct. Attribution obligatoire : « Data: Scuba Guide » avec un lien. Licence commerciale : via la page de contact.