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: Scuba Guide",并附链接。商业授权请通过联系页面洽谈。