# Введение Документация SkyLink API: авиаданные по REST через HTTPS — напрямую или через RapidAPI. Погода, аэропорты, рейсы, ADS-B, карты, оповещения и руководства для v2, v3 и v3.1. SkyLink — это REST API, который предоставляет авиационные данные в формате JSON по HTTPS через шлюз RapidAPI. Вы один раз оформляете подписку, отправляете аутентифицированные запросы на единый базовый URL и получаете структурированные ответы о погоде, аэропортах, рейсах, отслеживании воздушных судов в реальном времени и по историческим данным, картах, оповещениях и многом другом — без необходимости размещать конвейеры загрузки данных или самостоятельно поддерживать потоки данных. Эта страница помогает сориентироваться: что охватывает API, какую версию использовать и где описана каждая тема. Отдельные эндпоинты здесь не описываются — они находятся в справочных разделах версий. ## Что охватывает API [#whats-covered] * **Погода** — фактические приземные наблюдения и прогнозы в реальном времени, предупреждения на маршруте и ветер на высотах для США * **Аэропорты** — профили аэропортов, ВПП, частоты, радионавигационные средства (navaids) и многорежимный поиск по более чем 74 000 аэропортов * **Лётная эксплуатация** — статус рейсов в реальном времени, расписания вылетов и прилётов, расстояние и пеленг, предполётные брифинги на основе ИИ * **Отслеживание [ADS-B](https://www.faa.gov/air_traffic/technology/adsb)** — позиции воздушных судов в реальном времени с дополнением регистрационным номером, типом и авиакомпанией * **Исторические данные [ADS-B](https://www.faa.gov/air_traffic/technology/adsb)** — архивные данные о позициях воздушных судов; окна в 90 дней на тарифе Pro и выше, до 365 дней на тарифах Business, Enterprise и устаревших Ultra/Mega *(v3.1)* * **Поиск воздушных судов** — более 615 000 записей о ВС по регистрационному номеру или hex-адресу [ICAO24](https://en.wikipedia.org/wiki/ICAO_24-bit_address) * **Аэронавигационные карты** — карты в PDF для 91 страны (заход на посадку, SID, STAR, наземное движение, общие) * **Оповещения и предупреждения** — [NOTAM](https://www.icao.int/safety/pages/notam-service-profiles.aspx) и программы задержек [FAA NAS](https://www.faa.gov/about/office_org/headquarters_offices/ato/service_units/operations/at_delay_info) * **ML и ИИ** — оценка времени полёта, выбросы CO₂ и брифинги, сгенерированные ИИ * **Маршруты и вебхуки** — определение маршрута по позывному и push-уведомления о событиях рейса *(v3.1)* ## Версии API [#api-versions] SkyLink поддерживает три активные версии на одном хосте RapidAPI. Версию выбирает префикс пути (или его отсутствие) — при переходе между версиями хост менять не нужно. | Версия | Префикс на RapidAPI | Статус | | -------- | ----------------------------------------- | ------------------------------------------------- | | **v3.1** | *(нет — например, `/weather/metar/KJFK`)* | Последняя — рекомендуется для всех новых проектов | | **v3** | `/v3` | Стабильная, полнофункциональная | | **v2** | `/v2` (в базовом URL) | Поддерживается для обратной совместимости | ``` https://skylink-api.p.rapidapi.com ``` Новые интеграции стоит начинать с **v3.1**. Пользователи v3 или v2 могут сразу перейти к обзору своей версии. ## Как устроена эта документация [#how-this-documentation-is-organised] | Раздел | Что описывает | | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | | [Начало работы](/docs/getting-started) | Заявка на FREE Trial, подписка на RapidAPI, учётные данные, безопасность ключа, публичные эндпоинты, первый запрос | | [Обработка ошибок](/docs/errors) | Форматы HTTP-ошибок, уровни шлюза и API, правила повторных попыток | | [Ограничения частоты запросов](/docs/rate-limits) | Квоты тарифов, заголовки квот, стоимость превышения квоты, уровни путей исторических данных ADS-B | | [Справочник v3.1](/docs/v31/overview) | Полный перечень эндпоинтов последней версии *(начните отсюда)* | | [Справочник v3](/docs/v3/overview) | Перечень эндпоинтов стабильной версии | | [Справочник v2](/docs/v2/overview) | Перечень эндпоинтов устаревшей версии | На каждой справочной странице эндпоинта описаны путь, параметры, структура ответа, клиентские типы, примечания по интеграции и коды ошибок, специфичные для эндпоинта. Ошибки уровня всей платформы (аутентификация, валидация, ограничения частоты запросов, сбои сервера) описаны один раз в разделе [Обработка ошибок](/docs/errors), и на него ссылается каждая справочная страница. **Впервые работаете со SkyLink?** Начните с раздела [Начало работы](/docs/getting-started), затем откройте [справочник API v3.1](/docs/v31/overview). **Отлаживаете неудачный запрос?** См. [Обработка ошибок](/docs/errors). **Упираетесь в лимиты квоты?** См. [Ограничения частоты запросов](/docs/rate-limits).