API
L'atlante come database
Accesso JSON gratuito e in sola lettura al database in cache del sito — gli stessi dati strutturati visualizzati nelle pagine, con le stesse etichette di affidabilità e le stesse avvertenze. Nessuna chiave necessaria per un utilizzo personale o di ricerca ragionevole.
| Endpoint | Ritorni |
|---|---|
/api/v1/regions | Le 8 regioni subacquee |
/api/v1/countries | Guide per paese: stagioni, fasce di costo, range di temperatura dell'acqua |
/api/v1/destinations?country=®ion= | Destinazioni con i mesi migliori e i costi tipici |
/api/v1/destination/{slug} | Una destinazione incluso il riepilogo mese per mese, i siti e le specie |
/api/v1/sites?destination=&country=&type=&difficulty=&month= | Trova siti di immersione — schede strutturate |
/api/v1/site/{slug} | Un sito d'immersione, scheda completa incl. specie |
/api/v1/species?group= | Catalogo delle specie marine |
/api/v1/species/{slug} | Una specie incl. dove/quando è stata avvistata |
/api/v1/wrecks?country= | Database relitti |
/api/v1/liveaboards?region= | Directory liveaboard |
/api/v1/operators?destination= | Centri immersioni e resort |
/api/v1/parks | Aree marine protette |
/api/v1/chambers | Riferimento per la pianificazione iperbarica (NON dati di emergenza) |
/api/v1/season/{month} | Destinazioni in stagione per il mese 1–12 |
Esempio
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
Il contratto
Ogni risposta è un envelope: {"data": ..., "meta": {...}} — meta contiene conteggi, attribuzione, un timestamp as-of e il disclaimer. I valori sono intervalli ed etichette come visualizzati sul sito; un campo mancante significa non ancora verificato, mai zero. Cache di ~5 minuti; servita dal nostro database senza chiamate upstream live. Attribuzione obbligatoria: "Data: The Scuba Atlas" con un link. Licenze commerciali: tramite la pagina di contatto.
Prompt AI pronti all'uso per agenti che utilizzano questa API →