Пары маршрутов
Запрос статистики по конкретной паре «пункт отправления — пункт назначения». Возвращает перевозчиков, расстояние по ортодромии (km) и типичное блочное время (время от гейта до гейта на маршруте). Результаты отсортированы по количеству авиакомпаний. Чтобы получить полезную выборку, укажите хотя бы один из параметров departure или arrival.
Требования
x-api-key в каждом запросе (прямая подписка). Подробнее →Запрос
https://data.skylinkapi.com/v3.1/routes/pairs| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
departure | string | Нет | - | Аэропорт вылета, код IATA или ICAO |
arrival | string | Нет | - | Аэропорт прилёта, код IATA или ICAO |
limit | integer | Нет | 50 | Максимальное число результатов (1–500) |
Ответ
{
"count": 1,
"routes": [
{
"departure": "JFK",
"arrival": "LHR",
"airlines": ["American Airlines", "British Airways", "Delta Air Lines", "Virgin Atlantic"],
"km": 5555,
"duration_min": 430
}
]
}| Поле | Тип | Обязательный | Описание |
|---|---|---|---|
count | integer | Да | Число возвращённых строк маршрутов |
routes | array | Да | Та же структура элемента маршрута, что и в Маршруты аэропорта |
Клиентские типы
"""Route detection response models for /routes/* endpoints."""from __future__ import annotationsfrom dataclasses import dataclass@dataclassclass RoutePair: departure: str arrival: str airlines: list[str] km: int duration_min: int@dataclassclass CallsignRouteResponse: """Exact callsign match from GET /routes/callsign/{callsign}.""" callsign: str callsign_prefix: str airline_code: str departure_icao: str arrival_icao: str airports: list[str] confidence: str source: str routes: list[RoutePair] | None = None@dataclassclass AirportRoutesResponse: code: str direction: str count: int routes: list[RoutePair]@dataclassclass RoutePairsResponse: count: int routes: list[RoutePair]@dataclassclass RouteGuess: """Shape returned by route_guess() helper.""" callsign: str departure: str | None arrival: str | None confidence: str source: strИнтеграция
Примечания по реализации
Известны оба кода. Используйте этот эндпоинт, когда коды аэропортов вылета и прилёта уже известны и нужен контекст о перевозчиках и продолжительности, — это быстрее, чем перебирать все маршруты одного аэропорта.
Пагинация. Используйте limit при широких запросах с частичным совпадением; ограничения по умолчанию сохраняют размер ответа управляемым.
Ответы с ошибками
Ошибки валидации 422: раздел «Маршруты».
Your SkyLink licence key, for keys bought direct from skylinkapi.com.
In: header
Query Parameters
Filter by departure airport (IATA or ICAO)
Filter by arrival airport (IATA or ICAO)
Max results (default 50, max 500)
501 <= value <= 500Response Body
application/json
application/json
curl -X GET "https://data.skylinkapi.com/v3.1/routes/pairs"null{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}Маршруты аэропорта
Все известные маршруты с вылетом из аэропорта или прилётом в него — перевозчики, расстояние и типичное блочное время для каждой пары городов.
Аэронавигационные карты
PDF-схемы аэродромов для 91 страны — источники, категории GEN, GND, SID, STAR и APP с автоматическим выбором источника.