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 содержит счётчики, атрибуцию, временну́ю метку и оговорку. Значения являются диапазонами и метками, как отображается на сайте; отсутствующее значение означает «ещё не проверено», а не ноль. Кэш обновляется примерно каждые 5 минут; данные подаются из нашей базы данных без обращений к внешним источникам в реальном времени. Обязательная атрибуция: «Data: Scuba Guide» со ссылкой. Коммерческое лицензирование: через страницу контактов.