API
Атлас как база данных
Бесплатный доступ только для чтения через JSON к кешированной базе данных сайта — те же структурированные данные, что отображаются на страницах, с теми же метками достоверности и оговорками. Ключ не нужен для разумного личного и исследовательского использования.
| Эндпоинт | Возвращения |
|---|---|
/api/v1/regions | 8 регионов для дайвинга |
/api/v1/countries | Гиды по странам: сезоны, ценовые диапазоны, температура воды |
/api/v1/destinations?country=®ion= | Направления с лучшими месяцами и типичными расходами |
/api/v1/destination/{slug} | Одно направление, включая помесячный блок, сайты и виды |
/api/v1/sites?destination=&country=&type=&difficulty=&month= | Поиск дайв-сайтов — структурированные записи |
/api/v1/site/{slug} | Один дайв-сайт, полная запись, включая виды |
/api/v1/species?group= | Каталог морских видов |
/api/v1/species/{slug} | Один вид, включая места и время наблюдений |
/api/v1/wrecks?country= | База данных рэков |
/api/v1/liveaboards?region= | Каталог liveaboard |
/api/v1/operators?destination= | Дайв-центры и резорты |
/api/v1/parks | Морские заповедники |
/api/v1/chambers | Справочная информация по барокамерам для планирования (НЕ экстренные данные) |
/api/v1/season/{month} | Направления в сезоне для месяца 1–12 |
Пример
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
Договор
Каждый ответ — это конверт: {"data": ..., "meta": {...}} — meta содержит счётчики, атрибуцию, временну́ю метку as-of и дисклеймер. Значения — диапазоны и метки, как отображается на сайте; отсутствующее значение означает «ещё не проверено», никогда не ноль. Кэш ~5 минут; данные из нашей базы без живых upstream-запросов. Обязательная атрибуция: «Данные: The Scuba Atlas» со ссылкой. Коммерческое лицензирование — через страницу обратной связи.