API
Atlas sebagai data
JSON gratis dan hanya-baca dari database cache situs: data terstruktur yang sama yang dirender oleh halaman-halaman, dengan label kepercayaan dan catatan yang sama. Tidak perlu kunci untuk penggunaan pribadi dan penelitian yang wajar.
| Endpoint | Kembali |
|---|---|
/api/v1/regions | 8 wilayah menyelam |
/api/v1/countries | Panduan negara: musim, kisaran biaya, rentang suhu air |
/api/v1/destinations?country=®ion= | Destinasi dengan bulan terbaik dan biaya tipikal |
/api/v1/destination/{slug} | Satu destinasi lengkap dengan blok bulan per bulan, lokasi selam, dan spesiesnya |
/api/v1/sites?destination=&country=&type=&difficulty=&month= | Pencari lokasi selam: catatan terstruktur |
/api/v1/site/{slug} | Satu lokasi selam, data lengkap termasuk spesies |
/api/v1/species?group= | Katalog spesies laut |
/api/v1/species/{slug} | Satu spesies lengkap dengan lokasi/waktu perjumpaannya |
/api/v1/wrecks?country= | Database bangkai kapal |
/api/v1/liveaboards?region= | Direktori liveaboard |
/api/v1/operators?destination= | Pusat selam dan resor |
/api/v1/parks | Kawasan perlindungan laut |
/api/v1/chambers | Referensi perencanaan hiperbarik (BUKAN data darurat) |
/api/v1/season/{month} | Destinasi yang sedang musim untuk bulan 1–12 |
Contoh
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
Kontrak
Setiap respons adalah sebuah amplop, {"data": ..., "meta": {...}}, di mana meta memuat jumlah, atribusi, stempel waktu as-of, dan penafian. Nilai adalah rentang dan label seperti yang ditampilkan di situs; missing berarti belum diverifikasi, bukan nol. Cache sekitar 5 menit; disajikan dari database kami tanpa panggilan upstream langsung. Atribusi wajib: "Data: Scuba Guide" dengan tautan. Lisensi komersial: melalui halaman kontak.