Введение
SkyLink — это REST API, который предоставляет авиационные данные в формате JSON по HTTPS через шлюз RapidAPI. Вы один раз оформляете подписку, отправляете аутентифицированные запросы на единый базовый URL и получаете структурированные ответы о погоде, аэропортах, рейсах, отслеживании воздушных судов в реальном времени и по историческим данным, картах, оповещениях и многом другом — без необходимости размещать конвейеры загрузки данных или самостоятельно поддерживать потоки данных. Эта страница помогает сориентироваться: что охватывает API, какую версию использовать и где описана каждая тема. Отдельные эндпоинты здесь не описываются — они находятся в справочных разделах версий.
Что охватывает API
- Погода — фактические приземные наблюдения и прогнозы в реальном времени, предупреждения на маршруте и ветер на высотах для США
- Аэропорты — профили аэропортов, ВПП, частоты, радионавигационные средства (navaids) и многорежимный поиск по более чем 74 000 аэропортов
- Лётная эксплуатация — статус рейсов в реальном времени, расписания вылетов и прилётов, расстояние и пеленг, предполётные брифинги на основе ИИ
- Отслеживание ADS-B — позиции воздушных судов в реальном времени с дополнением регистрационным номером, типом и авиакомпанией
- Исторические данные ADS-B — архивные данные о позициях воздушных судов; окна в 90 дней на тарифе Pro и выше, до 365 дней на тарифах Business, Enterprise и устаревших Ultra/Mega (v3.1)
- Поиск воздушных судов — более 615 000 записей о ВС по регистрационному номеру или hex-адресу ICAO24
- Аэронавигационные карты — карты в PDF для 91 страны (заход на посадку, SID, STAR, наземное движение, общие)
- Оповещения и предупреждения — NOTAM и программы задержек FAA NAS
- ML и ИИ — оценка времени полёта, выбросы CO₂ и брифинги, сгенерированные ИИ
- Маршруты и вебхуки — определение маршрута по позывному и push-уведомления о событиях рейса (v3.1)
Версии API
SkyLink поддерживает три активные версии на одном хосте RapidAPI. Версию выбирает префикс пути (или его отсутствие) — при переходе между версиями хост менять не нужно.
| Версия | Префикс на RapidAPI | Статус |
|---|---|---|
| v3.1 | (нет — например, /weather/metar/KJFK) | Последняя — рекомендуется для всех новых проектов |
| v3 | /v3 | Стабильная, полнофункциональная |
| v2 | /v2 (в базовом URL) | Поддерживается для обратной совместимости |
https://skylink-api.p.rapidapi.comНовые интеграции стоит начинать с v3.1. Пользователи v3 или v2 могут сразу перейти к обзору своей версии.
Как устроена эта документация
| Раздел | Что описывает |
|---|---|
| Начало работы | Заявка на FREE Trial, подписка на RapidAPI, учётные данные, безопасность ключа, публичные эндпоинты, первый запрос |
| Обработка ошибок | Форматы HTTP-ошибок, уровни шлюза и API, правила повторных попыток |
| Ограничения частоты запросов | Квоты тарифов, заголовки квот, стоимость превышения квоты, уровни путей исторических данных ADS-B |
| Справочник v3.1 | Полный перечень эндпоинтов последней версии (начните отсюда) |
| Справочник v3 | Перечень эндпоинтов стабильной версии |
| Справочник v2 | Перечень эндпоинтов устаревшей версии |
На каждой справочной странице эндпоинта описаны путь, параметры, структура ответа, клиентские типы, примечания по интеграции и коды ошибок, специфичные для эндпоинта. Ошибки уровня всей платформы (аутентификация, валидация, ограничения частоты запросов, сбои сервера) описаны один раз в разделе Обработка ошибок, и на него ссылается каждая справочная страница.
Впервые работаете со SkyLink? Начните с раздела Начало работы, затем откройте справочник API v3.1. Отлаживаете неудачный запрос? См. Обработка ошибок. Упираетесь в лимиты квоты? См. Ограничения частоты запросов.