API
डेटा के रूप में एटलस
साइट के cached database पर Free, read-only JSON: वही structured data जो pages render करते हैं, उन्हीं confidence labels और caveats के साथ। उचित personal और research use के लिए कोई key नहीं चाहिए।
| एंडपॉइंट | वापसी |
|---|---|
/api/v1/regions | 8 डाइव क्षेत्र |
/api/v1/countries | देश गाइड: सीज़न, लागत बैंड, पानी की रेंज |
/api/v1/destinations?country=®ion= | सर्वश्रेष्ठ महीनों और सामान्य खर्च के साथ गंतव्य |
/api/v1/destination/{slug} | एक गंतव्य, जिसमें महीनेवार ब्लॉक, उसके साइट और प्रजातियाँ शामिल हैं |
/api/v1/sites?destination=&country=&type=&difficulty=&month= | Dive-site finder: structured records |
/api/v1/site/{slug} | एक डाइव साइट, पूरा रिकॉर्ड सहित प्रजातियाँ |
/api/v1/species?group= | समुद्री प्रजाति सूची |
/api/v1/species/{slug} | एक प्रजाति, जिसमें कहाँ/कब देखी गई यह जानकारी शामिल है |
/api/v1/wrecks?country= | Wreck डेटाबेस |
/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
अनुबंध
हर response एक envelope है, {"data": ..., "meta": {...}}, जहाँ meta में counts, attribution, एक as-of timestamp और disclaimer होते हैं। Values site पर दिखाई गई ranges और labels हैं; missing का मतलब अभी तक verify नहीं हुआ, कभी zero नहीं। लगभग 5 मिनट cached; हमारे database से serve किया गया, कोई live upstream calls नहीं। Attribution ज़रूरी है: "Data: Scuba Guide" एक link के साथ। Commercial licensing: contact page के ज़रिए।