API
Atlas dưới dạng dữ liệu
JSON chỉ đọc miễn phí qua cơ sở dữ liệu đệm của trang web: 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à các lưu ý. Không cần khóa API cho mục đích sử dụng 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= | Công cụ tìm địa đ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": {...}}, trong đó meta chứa số đếm, thông tin quy gán, dấu thời gian as-of và tuyên bố miễn trách nhiệm. Các giá trị là phạm vi và nhãn như được hiển thị trên trang; thiếu có nghĩa là chưa được xác minh, không bao giờ là số không. Bộ nhớ đệm khoảng 5 phút; được phục vụ từ cơ sở dữ liệu của chúng tôi mà không có cuộc gọi trực tiếp đến nguồn thượng lưu. Bắt buộc ghi nguồn: "Data: Scuba Guide" kèm liên kết. Cấp phép thương mại: qua trang liên hệ.