API
O atlas como dados
JSON gratuito e só de leitura sobre a base de dados em cache do site: os mesmos dados estruturados que as páginas apresentam, com os mesmos rótulos de confiança e ressalvas. Sem chave necessária para uso pessoal e de investigação razoável.
| Endpoint | Retornos |
|---|---|
/api/v1/regions | As 8 regiões de mergulho |
/api/v1/countries | Guias por país: temporadas, faixas de custo e variações de temperatura da água |
/api/v1/destinations?country=®ion= | Destinos com melhores meses e custos típicos |
/api/v1/destination/{slug} | Um destino incluindo o bloco mês a mês, seus pontos e espécies |
/api/v1/sites?destination=&country=&type=&difficulty=&month= | Localizador de locais de mergulho: registos estruturados |
/api/v1/site/{slug} | Um ponto de mergulho, registo completo incl. espécies |
/api/v1/species?group= | Catálogo de espécies marinhas |
/api/v1/species/{slug} | Uma espécie incl. onde/quando foram avistadas |
/api/v1/wrecks?country= | Base de dados de naufrágios |
/api/v1/liveaboards?region= | Diretório de liveaboards |
/api/v1/operators?destination= | Centros e resorts de mergulho |
/api/v1/parks | Áreas marinhas protegidas |
/api/v1/chambers | Referência de planeamento hiperbárico (NÃO é informação de emergência) |
/api/v1/season/{month} | Destinos em temporada para o mês 1–12 |
Exemplo
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
O contrato
Cada resposta é um envelope, {"data": ..., "meta": {...}}, onde meta inclui contagens, atribuição, um timestamp de referência e o aviso legal. Os valores são intervalos e rótulos tal como apresentados no site; em falta significa ainda não verificado, nunca zero. Cache de ~5 minutos; servido a partir da nossa base de dados sem chamadas upstream em tempo real. Atribuição obrigatória: "Data: Scuba Guide" com um link. Licenciamento comercial: através da página de contacto.