API
الأطلس بوصفه بيانات
وصول JSON مجاني للقراءة فقط عبر قاعدة بيانات الموقع المخزّنة — نفس البيانات المنظَّمة التي تعرضها الصفحات، مع نفس تصنيفات الموثوقية والتحفّظات. لا حاجة إلى مفتاح للاستخدام الشخصي والبحثي المعقول.
| نقطة النهاية (Endpoint) | العودة |
|---|---|
/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 الأعداد والإسناد وطابع زمني as-of والتنبيه التحذيري. القيم نطاقات وعلامات كما تظهر في الموقع؛ الحقل المفقود يعني غير موثَّق بعد، لا صفر. مخزَّن مؤقتًا ~5 دقائق؛ يُخدَّم من قاعدة بياناتنا دون استدعاءات خارجية مباشرة. الإسناد مطلوب: "Data: The Scuba Atlas" مع رابط. الترخيص التجاري: عبر صفحة التواصل.