API
L'atlas comme base de données
Accès JSON gratuit en lecture seule à la base de données en cache du site — les mêmes données structurées que celles affichées sur les pages, avec les mêmes niveaux de fiabilité et avertissements. 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= | Recherche de sites de plongée — fiches 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": {...}} — meta contient les compteurs, les attributions, un horodatage as-of et la clause de non-responsabilité. Les valeurs sont des fourchettes et des labels tels qu'affichés sur le site ; un champ manquant signifie non encore vérifié, jamais zéro. Mise en cache ~5 minutes ; servie depuis notre base de données sans appels externes en temps réel. Attribution obligatoire : « Data: The Scuba Atlas » avec un lien. Licence commerciale : via la page de contact.