API
L'atlante come database
JSON gratuito e in sola lettura sul database cached del sito: gli stessi dati strutturati che le pagine mostrano, con le stesse etichette di affidabilità e avvertenze. Nessuna chiave necessaria per un uso personale e 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= | Finder di 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": {...}}, dove meta contiene conteggi, attribuzione, un timestamp as-of e il disclaimer. I valori sono intervalli ed etichette come visualizzati sul sito; mancante significa non ancora verificato, mai zero. Cache di circa 5 minuti; servito dal nostro database senza chiamate upstream live. Attribuzione obbligatoria: "Data: Scuba Guide" con un link. Licenze commerciali: tramite la pagina dei contatti.
Prompt AI pronti all'uso per agenti che utilizzano questa API →