الواجهة مترجمة بالكامل، وكذلك كل صفحة مكتوبة: الدليل والمقالات التعليمية ومقالات البيانات والمدونة. ما يبقى بالفارسية هو ما يأتي من مصدر البيانات نفسه: أسماء المدن والمطارات وشركات الطيران والطائرات، والملاحظات المخزَّنة معها. ستظهر هذه بالفارسية إلى أن توفّر الواجهة البرمجية حقلاً عربياً لها.
API آسمانجو العام
كل ما يعرضه هذا الموقع يأتي من نقاط النهاية هذه؛ والصفحات نفسها ليست إلا قارئًا لها. جميعها للقراءة فقط، وجميعها تُعيد JSON إلا حيث كُتب خلاف ذلك، ولا يطلب أي منها مفتاحًا. وجذرها https://asemanjoo.ir .
استجابة هذه النقاط هي البيانات نفسها التي في ملفات التنزيل وتسري عليها الشروط نفسها: ذكر المصدر، وشرط «المشاركة بالمثل» في ODbL، ومنع إدراج المنشأ/الوجهة في قاعدة بيانات أخرى. صفحة الرخصة يقول بالضبط ما المسموح وما غير المسموح.
حد المعدّل
- بلا مفتاح120 طلبًا في الدقيقةيُحتسب على أساس شبكة عنوان الإنترنت، لا على أساس المتصفح.
- بجلسة المستخدم في هذا الموقع نفسه300 طلب في الدقيقةللصفحات التي يقرأها الموقع نفسه خلف حسابك.
- بمفتاح APIحصة منفصلة لكل مفتاحيُطلَب المفتاح عبر صفحة الاتصال وتُحدَّد حصته هناك؛ وترويسة الطلب هي X-API-Key.
كل استجابة تحمل ثلاث ترويسات X-RateLimit-Limit، X-RateLimit-Remaining و X-RateLimit-Reset موجود؛ وحين تنفد الحصة يكون الرد 429 و Retry-After يقول كم ثانية عليك الانتظار. النافذة دقيقة واحدة وتُحسب من جديد مع بداية كل دقيقة.
الإصدار والاستقرار
- كل عنوان تحت /api/ يستجيب أيضًا ببادئة /api/v1/؛ إنه التنفيذ نفسه، فلن يفترق الاثنان أبدًا.
- حذف عنوان، أو تغيير اسم معامل، أو تبدّل قيمته الافتراضية، كلها مقفلة في ملف اختبار؛ وتغييرها يجب أن يكون متعمَّدًا وقابلًا للمراجعة.
- تُحفظ استجابة النقاط الثقيلة مدةً ولها ترويسة ETag؛ فإن أرسلت If-None-Match تلقّيت استجابة 304 وبقيت نسختك السابقة صالحة.
- الطلب عابر النطاقات من المتصفح لا يُقبل إلا من asemanjoo.ir نفسه؛ ولأي استخدام آخر، اقرأ من جهة الخادم.
قبل أن تأخذ رقمًا على محمل الجد
- «غير معلوم» يعني أننا لا نعرف، ويأتي في استجابة JSON بقيمة فارغة (null) — لا بصفر. والسرعة صفر والارتفاع صفر، حيث لم يقل المرسل شيئًا، هما «غير معلوم» لا «صفر».
- لكل مبدأ ومقصد رحلة رتبةُ مصدر: 0 يعني لا شيء، 10 يعني جدول رموز النداء في adsbdb، 20 يعني ادعاءً لم يُسجَّل مصدره، 30 يعني الجدول الزمني للرحلات و40 يعني رصدنا نحن على الأرض. الرتبة 10 هي الأضعف: رمز النداء الواحد يطير عدة مسارات في اليوم الواحد وذلك الجدول يحتفظ بمسار واحد لكل رمز نداء.
- يُحفَظ مسار الرحلات نقطة بنقطة 30 يومًا، وسطر الرحلة نفسه سنة واحدة؛ أما التجميعات اليومية فلا تُمحى. أي أن «لم تكن هناك رحلة» و«لم نعد نحتفظ بها» شيئان مختلفان.
- تغطيتنا هي تغطية المستقبِلات التطوعية، لا تغطية السماء. حيث لا مستقبِل، لا رحلة — وهذا يظهر في إحصاءات المطارات قليلة المستقبِلات.
- الالتزام بالمواعيد والوقت المجدول متاحان لأقلية من الرحلات فقط، فهي عيّنة لا إحصاء شامل.
سماء هذه اللحظة
- /api/flights
كل رحلة تُرى في هذه اللحظة داخل الإطار المطلوب. الصفوف مصفوفات لا كائنات كي تبقى خفيفة؛ وترتيب الحقول هو ما تقرؤه خريطة الموقع نفسها.
south, north, west, east, since, limit
- /api/stats/live
عدد الرحلات المتتبَّعة الآن — رقم واحد، لمن لا يريد سواه.
- /api/stats/world
صورة العالم في هذه اللحظة: أكثر نقاط المغادرة والوجهات والشركات والطُّرز ازدحامًا بين الرحلات في الجو.
- /api/nearest
أقرب الرحلات إلى نقطة، مع المسافة بالكيلومترات.
lat, lon, radius_km, limit, ground
- /api/overhead
ما يمرّ فوق نقطة ما — أي سؤال «ما هذه الطائرة التي فوق رأسي».
lat, lon, radius_km, limit
- /api/density
كثافة الحركة في إطار الرؤية، لرسم طبقة الكثافة.
south, north, west, east, nx, ny
- /api/top
الرحلات التي لديها أكبر عدد من الزوّار على هذا الموقع الآن.
- /api/flights/emergency
الرحلات التي تبثّ رمز الاستجابة 7500 أو 7600 أو 7700. غالبًا ما تكون القائمة فارغة، وهذا في ذاته جواب.
- /api/feed/events.rss
قائمة الطوارئ نفسها بصيغة RSS، لقارئ الأخبار.
رحلة واحدة
- /api/flight/{flight_id}
كل شيء عن رحلة واحدة: المعرّف، الهيكل، المسار، الأثر المسجَّل والصور.
with_trail
- /api/flight/{flight_id}/live
الجزء المباشر وحده من الرحلة نفسها، لحين تكون الصفحة مفتوحة ولا تحتاج إلا إلى التحديث.
- /api/flight/{flight_id}/eta
الوقت المقدَّر للوصول. هو تقديرنا من السرعة والمسافة، لا إعلان شركة الطيران.
- /api/flight/{flight_id}/geojson
أثر الرحلة نفسها بصيغة GeoJSON، لوضعه على أي خريطة أخرى.
- /api/flight/{flight_id}/playback
إعادة عرض لأثر الرحلة من مخزننا، نقطةً نقطة.
max_points
- /api/flight/{flight_id}/history
الرحلات السابقة برقم الرحلة نفسه — «متى تهبط هذه الرحلة عادةً».
limit
- /api/replay
إعادة عرض لإطار من الخريطة في مدة زمنية ماضية.
south, north, west, east, start, minutes, max_flights, stream
- /api/replay/export
تصدير إعادة العرض نفسها إلى ملف GeoJSON أو CSV — للتدقيق والبحث، لا فيديو.
south, north, west, east, start, minutes, max_flights, format
- /api/replay/airport/{iata}
إعادة عرض للرحلات التي هبطت في هذا المطار أو أقلعت منه خلال مدة زمنية — والاختيار بحسب الرحلة لا بحسب الإطار الجغرافي، كي لا تسقط من إعادة العرض رحلةٌ تخرج من الإطار.
start, minutes, max_flights
مطار
- /api/airports
قائمة المطارات بالاسم الفارسي والإحداثيات وعدد الحركات.
fields, format
- /api/airports.csv
القائمة نفسها بصيغة CSV، لجدول البيانات.
- /api/airports/bbox
المطارات داخل إطار، للخريطة.
south, north, west, east, limit
- /api/airports/compare
مطاران جنبًا إلى جنب، بالأرقام نفسها التي تعرضها صفحة المقارنة.
a, b, days
- /api/airports/disruptions
ترتيب عالمي وإقليمي للمطارات استنادًا إلى مؤشّر لحظي للاضطراب والتأخير وإلغاء الرحلات.
hours, limit, region
- /api/airport/{iata}
مطار واحد: الاسم والإحداثيات والمدارج والطقس والإحصاءات الأخيرة.
- /api/airport/{iata}/full
الأجوبة الأربعة أعلاه — المطار، واللوحة، والإحصاءات، والتوقّعات — في طلب واحد.
kind, days, board_before, board_after, stats_days, radius_km
- /api/airport/{iata}/board
لوحة وصول ومغادرة المطار نفسه.
kind, before, after
- /api/airport/{iata}/stats
السلسلة الزمنية لحركة المطار، يومًا بيوم.
days
- /api/airport/{iata}/delay
حالة تأخير المطار، في هذه اللحظة وخلال المدة الأخيرة — مع حالة «غير معروف» الصريحة حين تكون العيّنة قليلة.
days, hours
- /api/airport/{iata}/routes
أكثر وجهات المطار نفسه تكرارًا في المدة الأخيرة.
days, limit
- /api/airport/{iata}/ground
الطائرات التي تُرى في هذه اللحظة على أرض ذلك المطار.
radius_km, limit
- /api/airport/{iata}/departures.xml
تغذية RSS لمغادرات المطار نفسه — لوحة المغادرة ذاتها، للاشتراك بها في قارئ أخبار دون حساب.
- /api/airport/{iata}/departures.json
التغذية نفسها بصيغة JSON Feed 1.1، للمستهلك المبرمج.
- /api/airport/{iata}/trails
آثار الوصول والمغادرة الأخيرة للمطار نفسه، مكثَّفة وجاهزة للعرض على الخريطة (E-274).
days
المسار والشركة والطراز والبلد والطائرة
- /api/routes
كل المسارات ذات الحركة، صفحة بصفحة بمؤشر مفتاحي (cursor).
cursor, limit
- /api/route/{orig}/{dest}
مسار واحد: عدد الرحلات والهبوطات والهياكل التي تطيره.
- /api/route/{orig}/{dest}/geojson
المسار نفسه بصيغة GeoJSON.
- /api/city/{slug}
مدينة واحدة: مطاراتها وحركتها المجمَّعة وأكثر الوجهات ازدحامًا.
days
- /api/city-pair/{orig}/{dest}
كل أزواج المطارات بين مدينتين، مجموعة في استجابة واحدة.
days
- /api/route/{orig}/{dest}/trails
الآثار الأخيرة لرحلات هذا المسار نفسه، مكثَّفة وجاهزة للعرض على الخريطة (E-46).
days
- /api/route/{orig}/{dest}/path
المسار المعتاد لهذا الخط، محسوبًا من وسيط المسارات الأخيرة — لا مسار رحلة بعينها (L-90).
days
- /api/route/{orig}/{dest}/seasonality
النمط الموسمي لهذا المسار موزّعًا على أشهر التقويم الشمسي، من سجل stats_daily_route الدائم (L-92).
- /api/busiest
أكثر المطارات والمسارات ازدحامًا في الثلاثين يومًا الماضية، في استجابة واحدة.
- /api/busiest/airports.csv
ترتيب المطارات نفسه بصيغة CSV.
- /api/busiest/routes.csv
ترتيب المسارات نفسه بصيغة CSV.
- /api/stats/extremes
أطول المسارات وأقصرها التي رأيناها.
limit, min_flights
- /api/airlines
قائمة شركات الطيران بالاسم الفارسي وعدد الرحلات.
- /api/airline/{iata}
شركة طيران واحدة: الأسطول والوجهات وعدد الرحلات.
days
- /api/airline/{iata}/history
إحصاءات الشركة نفسها في مدة تحدّدها أنت.
start, end
- /api/types
قائمة أنواع الطائرات بعدد الرحلات.
- /api/type/{code}
نوع طائرة واحد: الهياكل المرصودة وأكثر المسارات استخدامًا.
days
- /api/countries
قائمة البلدان بعدد المطارات وحركة السير.
- /api/country/{code}
رحلات بلد ومطاراته.
days
- /api/aircraft/{reg}
هيكل واحد بحسب رقم التسجيل: المواصفات والرحلات الأخيرة.
days
- /api/aircraft/{reg}/history
رحلات الهيكل نفسه في مدة تحدّدها أنت.
start, end, limit
إحصاءات وتنزيلات
- /api/stats/daily
العدد اليومي للرحلات والمسارات والمطارات والطُّرز. مع format=csv يعطي الشيء نفسه بصيغة CSV.
days, format
- /api/stats/world/series
السلسلة الزمنية للعدد العالمي للرحلات، عيّنة كل خمس دقائق — حتى سبعة أيام مضت. الفترة التي لم يأخذ فيها المجمِّع أي عيّنة تبقى فارغة؛ ولا تُستكمَل بأي قيمة بدلًا منها.
hours
- /api/download/datasets
قائمة قابلة للقراءة آليًا بمجموعات البيانات المتاحة للتنزيل: أسماء الأعمدة والعنوان ونص الرخصة لكل منها.
- /api/download/{dataset}.csv
إحدى التجميعات اليومية أو السنوية بصيغة CSV، بترويسة تحمل وقت الإنشاء والرخصة داخل الملف نفسه. `days` يحدّ التجميعات اليومية فقط؛ أما السنوية فتعطي كامل المدة المسجَّلة.
days
بحث
- /api/search
بحث واحد يشمل المطارات والشركات والرحلات والمسارات وأرقام التسجيل.
q
- /api/search/suggest
اقتراح قصير أثناء الكتابة.
q, limit
- /api/search/advanced
بحث بمرشّحات مركّبة: الشركة، والطراز، والارتفاع، والسرعة، والمطار.
airline, aircraft_type, orig, dest, min_alt, max_alt, min_spd, max_spd, ground, limit
- /api/search/history
البحث عن رقم رحلة أو رمز نداء أو تسجيل ضمن مدى تاريخي — حتى سنة مضت.
q, from, to, limit
الطقس والمجال الجوي والمصادر
- /api/wx/hazard
تحذيرات أرصاد الطيران (SIGMET/AIRMET) داخل إطار العرض.
south, north, west, east, limit
- /api/tfr
قيود الطيران المؤقتة الأمريكية السارية (TFR) داخل الإطار، مع النوع (رياضي/خطر/أمني/فضائي/VIP/تجمّع مسيّرات/خاص) ونطاق سريانها الزمني.
south, north, west, east, limit
- /api/oceanic-tracks
المسارات المحيطية المنظَّمة السارية في هذه اللحظة (NAT-OTS وPACOTS وAUS-OTS) مع مصدر كل نظام وجملة حالة واحدة.
- /api/wx/turbulence
طبقة المطبّات: تقرير الطيار (PIREP، «مُبلَّغ عنه») وقصّ الرياح النموذجي بين مستويين متجاورين («مُقدَّر») داخل إطار العرض — طبقتان فرعيتان منفصلتان.
south, north, west, east, limit
- /api/airspace/fir
حدود مناطق معلومات الطيران (FIR) داخل الإطار.
south, north, west, east, zoom, limit
- /api/airspace/at
في أي منطقة معلومات طيران تقع هذه النقطة.
lat, lon
- /api/map/ground
معينات الملاحة والمدارج داخل الإطار، للطبقة الأرضية من الخريطة.
south, north, west, east, runways, limit
- /api/sources
الحالة المباشرة لمصادر البيانات: أيّها يستجيب وكم حصة كلٍّ منها.
hours
العمق: الالتزام بالمواعيد وسلامة البيانات وإيران
- /api/punctuality
المطارات التي تبلغ عيّنة مغادراتها حدّ النشر الأدنى، مع نافذة البيانات الحقيقية. ولا تُعاد أي نسبة مئوية — البسط والمقام منفصلان، كي لا تصل إلى القارئ حصة بلا عيّنتها.
- /api/punctuality/{iata}
الانضباط الزمني لمطار: لوحة اليوم مقابل المتوسط، منحنى الساعة المحلية، ترتيب الشركات، وعدد ما استبعده حدّ العيّنة الأدنى.
- /api/airport/{iata}/conditions
تنبؤ المطار (TAF) وتحذيرات المسار النشطة (SIGMET) ضمن نطاقه. منفصل عن صفحة المطار، لأن عمر التحذير ساعات لا ثلاثون يومًا.
radius_km
- /api/aircraft/{reg}/activity
سجلّ ثلاثين يومًا لطائرة واحدة: كم رحلة في كل يوم ومن أي المطارات. واليوم الصفر يعني يومًا نظرنا فيه فلم نرَ شيئًا.
- /api/aircraft/{reg}/distance
مجموع المسافة التي رصدها آسمانجو من طائرة واحدة — لا مسافة عمر تلك الطائرة. ونطاق الرصد وعدد الأيام غير المجمَّعة يأتيان في الاستجابة نفسها، لأن الرقم لا يُقرأ بدونهما.
- /api/aircraft/{reg}/utilization
إنتاجية طائرة واحدة: متوسط ساعات الطيران في اليوم ومتوسط التوقف الأرضي بين رحلتين، خلال المدة المعطاة. والطائرة التي لها رحلات مسجَّلة في أقل من خمسة أيام مختلفة لا تحصل على رقم.
days
- /api/airline/{iata}/fleet-utilization
الإنتاجية نفسها، لكامل أسطول شركة طيران: صف لكل رقم تسجيل، إضافة إلى متوسط الأسطول على ما بلغ منها حدّ العيّنة الأدنى.
days, limit
- /api/airline/{iata}/fleet
الطائرات التي رأيناها لهذه الشركة — لا الأسطول الرسمي — مع ما إذا كانت كل واحدة في الجو الآن أم على الأرض، وإن كانت على الأرض فمتى وأين رُصدت آخر مرة. وأي تسجيل ظلّ متوقفًا طوال المدة ليس في هذه القائمة.
days, limit
- /api/airline/{iata}/operated-by
للرحلات المباعة تحت رمز هذه الشركة: مشغّلها الفعلي حين يختلف عن الشركة نفسها — علامة تأجير رطب. تابع قراءته عبر `/api/operator/{icao}`.
days
- /api/operator/{icao}
المشغّل الفعلي لأسطول بدل بائع التذاكر — بالشكل نفسه لـ `/api/airline/{iata}`، لكن �ستنادًا إلى من شغّل الطائرة فعلًا، لا إلى الرمز الذي بيعت تحته التذكرة.
days
- /api/airline/{iata}/fleet-wikidata
مصدر ثانٍ مستقل للسؤال نفسه: الطائرات التي تعرفها ويكي بيانات (لا مستقبِلاتنا) لهذه الشركة. وهذا أيضًا ليس الأسطول الرسمي — فويكي بيانات تسجّل الطائرات البارزة واحدة واحدة لا الأسطول كاملًا، فالعدّ حدّ أدنى لا حدّ أقصى.
limit
- /api/type/{code}/sectors
ما المسافات التي يقطعها هذا الطراز: الوسيط، والتشتّت، ونطاقات مسافة ثابتة كي يمكن مقارنة طرازين معًا.
- /api/type/{code}/live
إحصاء لحظي لهذا الطراز: كم طائرة من هذا الطراز تُرى في السماء الآن — من جدول الخادم المباشر ذاته، لا من عدّ خريطة المتصفح المحدود بسقف الاتصال.
- /api/emergency/history
أرشيف رموز الطوارئ (٧٥٠٠/٧٦٠٠/٧٧٠٠) مع بداية التسجيل. ونهاية الحدث تعني أن الطائرة لم تعد ترسل ذلك الرمز — ولا تقول شيئًا عن مصيرها.
- /api/digest/today
ملخّص اليوم منذ منتصف الليل في طهران: عدد الرحلات، وأكثر المسارات ازدحامًا، وأطول وأقصر رحلة مرصودة، ورموز الطوارئ اليوم. قد يكون أي قسم فارغًا — أي أننا لم نلتقط شيئًا اليوم، لا أن الاستعلام أخفق.
- /api/data-health
ما يعرفه الموقع عن نفسه: نسبة الرحلات التي لها مسار وارتفاع وتسجيل، وتوافر المجمِّع، ونصيب كل مصدر. «لم يُقَس» و«سليم» جوابان مختلفان.
days
- /api/iran/today
سماء إيران من منتصف الليل بتوقيت طهران حتى هذه اللحظة. ما رأيناه، لا ما طار — التغطية ليست متجانسة.
- /api/iran/airports
مطارات إيران مع المدرج والارتفاع ومعينات الملاحة. أعمدة المرجع مفصولة عن عمود ما رُصد.
- /api/iran/network
أزواج المدن الداخلية مرتَّبة بحسب الرحلات المرصودة، والاتجاهان يُحسبان واحدًا. يُعاد كلٌّ من الحدّ الأدنى للعيّنة وما استبعده.
- /api/iran/fleet
الطائرات المسجّلة في إيران التي رأيناها. «لم تُرصد» تعني أننا لم نسمعها؛ ولا يُستنتج من ذلك توقّفها على الأرض.
القياسات الخام للأسطول: الرياح، وسلامة تحديد الموقع، والنيّة
- /api/wx/wind
رياح وحرارة قاستها الطائرات نفسها، خليةً خليةً بدرجة واحدة — لا تنبّؤ. وتعود ثلاثة أرقام منفصلة للريح: الاتجاه المتّجهي (متوسط ٣٥٠ و٠١٠ درجة هو ٠٠٠ لا ١٨٠)، والسرعة العددية، وطول المتّجه الذي يقول كم كانت الريح منتظمة. والخلية التي لم يقس فيها أحد ريحًا هي «غير معروفة» لا «هادئة».
south, north, west, east, band, hours, min_wind, limit
- /api/gnss/integrity
حيث أبلغت الطائرات عن فقدان موقعها الساتلي، على شبكة بنصف درجة. كل عدّ يأتي بمقامه الخاص؛ خانة بقراءات صفر ليس لها معدّل وليست سماءً صافية، بل هي عمانا. تقول coverage كم ساعة من التاريخ في هذا الجدول أصلًا.
south, north, west, east, hours, min_readings, limit
- /api/gnss/integrity/series
الأرقام نفسها، ساعة بساعة بدل خانة بخانة. الساعة التي لم تكن فيها رحلة داخل الإطار لا صف لها أصلًا — هي فراغ، لا حفرة صفر؛ وملؤها يرسم انقطاع المجمِّع على أنه تحسّن مفاجئ في السماء.
south, north, west, east, hours
- /api/flight/{flight_id}/intent
الارتفاع والرمز الذي اختاره الطيار على امتداد رحلة واحدة، سطر لكل تغيير. الرحلة غير الموجودة تحصل على 404 والرحلة الموجودة بلا أحداث تحصل على قائمة فارغة — كي لا يختلط «لم نسمع شيئًا» بـ«لا توجد رحلة كهذه».
limit
- /api/airport/{iata}/stand
أقرب موقف مرسوم على الخريطة إلى نقطة على الأرض. هو تقدير لا تخصيص: لا مصدر يقول على أي موقف تقف الطائرة. وخارج نصف القطر تكون الإجابة null، لا أقرب موقف في أي مكان. الهندسة من OpenStreetMap وبموجب ODbL.
lat, lon, max_m
- /api/airport/{iata}/stand/by-ref
موقع موقف الطائرة من رقم البوابة أو الموقف المكتوب في جدول الرحلة. هي مطابقة اسم لا تخمين مسافة؛ وغياب المطابقة الدقيقة يعني أن stand يساوي null، لا أقرب موقف. الهندسة من OpenStreetMap وبموجب ODbL.
ref
- /api/military
الرحلات التي صنّفتها قاعدة بيانات الهياكل في شبكة المستقبِلات على أنها عسكرية. هذا تصنيف المصدر الأعلى، لا حكم آسمانجو، وهو غير مدموج مع تخمين رمز النداء وبادئة طراز الطائرة في مرشِّح الخريطة. وهو عالمي وبلا أي مرشِّح جغرافي. والعمود الفارغ يعني «غير معروف» لا صفرًا — والمسار غير المعروف أمر عادي في هذه القائمة. [[E-284]]: يحمل كل صف إضافةً إلى ذلك block_country وblock_military — إشارة مستقلة مستمدة من مجال عنوان ICAO ذي الأربعة والعشرين بت، منفصلة عن العمود الرئيسي وبلا دمج؛ ويشرحها block_basis.
days, limit
- /api/coverage/grid
خريطة تغطية رصدنا نحن: كل خلية 5×5 درجات مع عدد السجلات المسجَّلة وعدد الطائرات الفريدة ووسم «بلا تغطية/عيّنة قليلة/عيّنة كثيفة». والخلية التي لا سجل لها في هذه المدة هي «بلا تغطية» لا «بلا حركة» — فغياب المستقبِل وغياب الرحلة لا يمكن تمييزهما، وهذا الاستعلام لا يعدّهما شيئًا واحدًا. وsparsest يسمّي أقل عشر خلايا عيّنةً.
hours
إصدار API
- /api/versions
الإصدارات التي تستجيب لها هذه الخدمة، وأيها الإصدار الجاري، وتاريخ إهمال كل منها أو انتهاء الاستجابة له (وحتى يُحدَّد، null). والعميل الذي لا يُحدَّث مع الخدمة ينبغي أن ينادي تحت بادئة الإصدار الجاري نفسها: تحت /api/v1/ تُضاف الحقول، لكنها لا تُحذف ولا يتغيّر نوعها. والمسار بلا بادئة هو التطبيق نفسه لكنه لا يحمل هذا الالتزام، وهو مُعلَّم في هذه الاستجابة بـ stable: false.
ما لم يُوثَّق عمدًا
هذه العناوين تستجيب أيضًا، لكنها ليست واجهة عامة: فهي إما استقصاء تشغيلي، وإما أن استجابتها مرتبطة بجلستك، وإما أن صيغتها تخصّ خريطتنا نحن وتتغيّر معها. لا تبنِ عليها شيئًا.
- /api/healthفحص تشغيلي؛ لمراقبة الخدمة لا للبيانات.
- /api/health/liveفحص حياة الحاوية.
- /api/health/readyفحص الجاهزية لموازن الحمل.
- /api/health/deepفحص عميق للاعتماديات؛ مكلف ومكتوب للمشغّل.
- /api/status-historyفحص تشغيلي؛ هو سجل توافر الخدمة نفسها (H-35)، لا بيانات عن الرحلات — خلف /status، مثل /api/health.
- /api/ops/metricsمقاييس Prometheus، للمراقبة.
- /api/noticeرسالة الموقع العامة؛ محتواها قرارنا نحن، لا بيانات.
- /api/color-themeإعدادات السمة وألوان واجهة مستخدم الخريطة؛ وهي لواجهة الموقع الأمامية، لا للبيانات.
- /api/paletteالطلاء الافتراضي للواجهة الذي اختاره المشغّل؛ وهو مثل /api/color-theme قرار مظهري خاص بالموقع نفسه، لا بيانات عن الرحلات.
- /api/content/{slug}الكتلة النصية لصفحة ثابتة (K-29)؛ وهي للدمج في الصفحة نفسها التي تقرأ هذا الـ slug فقط، لا بيانات مستقلة.
- /api/glossaryإضافات اللوحة وتصحيحاتها على المعجم الثابت (K-30)؛ وهي للدمج من جهة الخادم في `/glossary` فقط.
- /api/faqالأسئلة المضافة من اللوحة (K-31)؛ وهي للدمج من جانب الخادم في `/faq` فقط.
- /api/marksتعتمد استجابته على جلسة المستخدم المسجَّل، ولا معنى لها لغيره.
- /api/streamبثّ SSE لخريطتنا نحن؛ شكل صفوفه يتغيّر مع الخريطة ولم نَعِد بثباته.
- /api/sitemapمصنوع لمحرّكات البحث.
- /api/sitemap/{name}الشيء نفسه، قسمًا قسمًا.
- /api/public/coverage/gridانعكاس لـ `/api/coverage/grid` نفسه ضمن المجموعة الفرعية المُصدَّرة والموثّقة علنًا (G-143) — وشرحه في «/api-docs» لا هنا، كي لا تُشرح بيانة واحدة مرتين.
- /api/public/sourcesانعكاس لـ `/api/sources` نفسه ضمن المجموعة الفرعية العامة نفسها — والشرح في «/api-docs».
- /api/public/openapi.jsonوثيقة OpenAPI للمجموعة الفرعية العامة نفسها؛ هي بنية لا بيانات.
- /api/public/docsواجهة Swagger UI للوثيقة نفسها؛ إنها صفحة، لا بيانات.
ملف، بدل السؤال
إن أردت تجميعًا جاهزًا لا استعلامًا حيًّا، صفحة التنزيل يعطي البيانات نفسها بصيغة CSV ويقول ما الذي حجبناه عمدًا. وقائمة المصادر العليا في صفحة مصادر البيانات .