APIِ عمومیِ آسمان‌جو

• بدونِ کلید۱۲۰ درخواست در دقیقهبر پایهٔ شبکهٔ نشانیِ اینترنتی شمرده می‌شود، نه بر پایهٔ مرورگر.
• با نشستِ کاربریِ همین سایت۳۰۰ درخواست در دقیقهبرای صفحه‌هایی که خودِ سایت پشتِ حسابِ شما می‌خواند.
• با کلیدِ APIسهمِ جداگانه برای هر کلیدکلید از راهِ صفحهٔ تماس گرفته می‌شود و سهمش همان‌جا تعیین می‌شود؛ سرآیندِ درخواست X-API-Key است.

هر پاسخ سه سرآیندِ X-RateLimit-Limit، X-RateLimit-Remaining و X-RateLimit-Reset دارد؛ وقتی سهم تمام شود پاسخ ۴۲۹ است و Retry-After می‌گوید چند ثانیه صبر کنید. پنجره یک دقیقه است و از ابتدای هر دقیقه از نو شمرده می‌شود.

• هر نشانی زیرِ ‎/api/‎ با پیشوندِ ‎/api/v1/‎ هم جواب می‌دهد؛ همان یک پیاده‌سازی است، پس این دو هرگز از هم جدا نمی‌افتند.
• حذفِ یک نشانی، تغییرِ نامِ یک پارامتر یا عوض‌شدنِ مقدارِ پیش‌فرضش، همه در یک پروندهٔ آزمون قفل شده‌اند؛ تغییرشان باید عمدی و قابلِ بازبینی باشد.
• پاسخِ نقطه‌های سنگین برای مدتی نگهداری می‌شود و سرآیندِ ETag دارد؛ اگر ‎If-None-Match‎ بفرستید، پاسخِ ۳۰۴ می‌گیرید و همان نسخهٔ قبلی‌تان معتبر است.
• درخواستِ میان‌دامنه‌ای از مرورگر فقط از خودِ asemanjoo.ir پذیرفته می‌شود؛ برای کاربردِ دیگر، از سمتِ کارگزار بخوانید.

• «نامعلوم» یعنی نمی‌دانیم، و در پاسخِ JSON با تهی (null) می‌آید — نه با صفر. سرعتِ صفر و ارتفاعِ صفر هم در جایی که فرستنده چیزی نگفته، «نامعلوم»‌اند نه «صفر».
• مبدأ و مقصدِ هر پرواز رتبهٔ منشأ دارد: ۰ یعنی هیچ، ۱۰ یعنی جدولِ کال‌ساینِ adsbdb، ۲۰ یعنی ادعایی که منبعش ثبت نشده، ۳۰ یعنی برنامهٔ پروازی و ۴۰ یعنی مشاهدهٔ خودمان روی زمین. رتبهٔ ۱۰ ضعیف‌ترین است: یک کال‌ساین در یک روز چند مسیر می‌پرد و آن جدول برای هر کال‌ساین یک مسیر دارد.
• ردِ نقطه‌به‌نقطهٔ پروازها ۳۰ روز نگهداری می‌شود و خودِ ردیفِ پرواز یک سال؛ رول‌آپ‌های روزانه پاک نمی‌شوند. یعنی «هیچ پروازی نبوده» و «دیگر نگهش نداشته‌ایم» دو چیزند.
• پوششِ ما پوششِ گیرنده‌های داوطلبانه است، نه پوششِ آسمان. جایی که گیرنده نیست، پرواز هم نیست — و این در آمارِ فرودگاه‌های کم‌گیرنده دیده می‌شود.
• خوش‌قولی و زمانِ برنامه‌ای فقط برای اقلیتی از پروازها موجود است، پس نمونه است نه سرشماری.

• /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

  پروازهایی که اسکواکِ ۷۵۰۰، ۷۶۰۰ یا ۷۷۰۰ می‌زنند. اغلب فهرست خالی است و همان هم یک پاسخ است.

• /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/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

  جایی که هواپیماها گزارشِ از دست رفتنِ موقعیتِ ماهواره‌ای داده‌اند، روی شبکهٔ نیم‌درجه‌ای. هر شمارش با مخرجِ خودش می‌آید؛ خانه‌ای با readings صفر نرخ ندارد و آسمانِ پاک نیست، نابیناییِ ماست. coverage می‌گوید این جدول اصلاً چند ساعت تاریخ دارد.

  south, north, west, east, hours, min_readings, limit

• /api/gnss/integrity/series

  همان اعداد، ساعت‌به‌ساعت به‌جای خانه‌به‌خانه. ساعتی که هیچ پروازی در کادر نبوده، اصلاً ردیفی ندارد — جای خالی است، نه گودالِ صفر؛ پرکردنش قطعیِ گردآور را به‌صورتِ بهبودِ ناگهانیِ آسمان می‌کشد.

  south, north, west, east, hours

• /api/flight/{flight_id}/intent

  ارتفاع و کدِ انتخابیِ خلبان در طولِ یک پرواز، یک ردیف به ازای هر تغییر. پروازِ ناموجود ۴۰۴ می‌گیرد و پروازِ موجودِ بی‌رویداد فهرستِ خالی — تا «چیزی نشنیدیم» با «چنین پروازی نیست» یکی نشود.

  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

  نقشهٔ پوششِ رصدِ خودمان: هر خانهٔ ۵×۵ درجه با شمارِ رکوردهای ثبت‌شده، شمارِ هواپیمای یکتا و برچسبِ «بدونِ پوشش/کم‌نمونه/پرنمونه». خانه‌ای که هیچ رکوردی در این بازه نداشته «بدونِ پوشش» است، نه «بدونِ ترافیک» — نبودِ گیرنده و نبودِ پرواز از هم قابلِ‌تشخیص نیستند و این پرسش آن دو را یکی نمی‌شمارد. sparsest ده خانهٔ کم‌نمونه‌ترین را نام می‌برد.

  hours

این نشانی‌ها هم جواب می‌دهند، ولی رابطِ عمومی نیستند: یا کاوشِ عملیاتی‌اند، یا پاسخشان به نشستِ شما بسته است، یا قالبشان مالِ نقشهٔ خودِ ماست و با آن عوض می‌شود. رویشان چیزی نسازید.

• /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/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 می‌دهد و می‌گوید چه چیزی را عمداً بیرون نداده‌ایم. فهرستِ منابعِ بالادست هم در صفحهٔ منابعِ داده است.