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= | 船宿目录 |
/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: The Scuba Atlas",并附链接。商业授权请通过联系页面洽谈。