API
Atlas dưới dạng dữ liệu
JSON chỉ đọc miễn phí qua cơ sở dữ liệu cache của trang — cùng dữ liệu có cấu trúc mà các trang hiển thị, với cùng nhãn độ tin cậy và lưu ý. Không cần khóa API cho mục đích cá nhân và nghiên cứu hợp lý.
| Endpoint | Kết quả trả về |
|---|---|
/api/v1/regions | 8 khu vực lặn |
/api/v1/countries | Cẩm nang quốc gia: mùa vụ, mức chi phí, nhiệt độ nước |
/api/v1/destinations?country=®ion= | Điểm đến với các tháng tốt nhất và chi phí tham khảo |
/api/v1/destination/{slug} | Một điểm đến bao gồm khung thông tin theo từng tháng, các địa điểm lặn và các loài sinh vật |
/api/v1/sites?destination=&country=&type=&difficulty=&month= | Tìm kiếm điểm lặn — hồ sơ có cấu trúc |
/api/v1/site/{slug} | Một địa điểm lặn, hồ sơ đầy đủ bao gồm các loài sinh vật |
/api/v1/species?group= | Danh mục các loài sinh vật biển |
/api/v1/species/{slug} | Một loài sinh vật bao gồm địa điểm/thời điểm quan sát được |
/api/v1/wrecks?country= | Cơ sở dữ liệu xác tàu |
/api/v1/liveaboards?region= | Danh mục liveaboard |
/api/v1/operators?destination= | Trung tâm và khu nghỉ dưỡng lặn |
/api/v1/parks | Các khu vực bảo tồn biển |
/api/v1/chambers | Tài liệu tham khảo lập kế hoạch buồng giảm áp (KHÔNG dùng trong trường hợp khẩn cấp) |
/api/v1/season/{month} | Điểm đến đang vào mùa cho tháng 1–12 |
Ví dụ
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
Hợp đồng
Mọi phản hồi đều là một phong bì: {"data": ..., "meta": {...}} — meta chứa số lượng, thuộc tính, dấu thời gian as-of và tuyên bố từ chối trách nhiệm. Các giá trị là khoảng và nhãn như hiển thị trên trang; thiếu có nghĩa là chưa xác minh, không bao giờ là không. Được lưu cache ~5 phút; được phục vụ từ cơ sở dữ liệu của chúng tôi mà không có lệnh gọi upstream trực tiếp. Yêu cầu ghi nguồn: "Data: The Scuba Atlas" kèm liên kết. Cấp phép thương mại: qua trang liên hệ.