Маршруты аэропорта

Список всех маршрутов из указанного аэропорта или в него. Возвращает элементы маршрутов с авиакомпаниями, расстоянием и продолжительностью — удобно для представлений маршрутной сети хабов и обогащения расписаний.

Требования

Авторизация

x-api-key в каждом запросе (прямая подписка). Подробнее →

Запрос

GEThttps://data.skylinkapi.com/v3.1/routes/airport/{code}

Параметр	Тип	Обязательный	По умолчанию	Описание
`code`	string	Да	-	Код аэропорта IATA (3 буквы, например `MXP`) или ICAO (4 буквы, например `LIMC`)
`direction`	string	Нет	`both`	`dep` (вылеты), `arr` (прилёты) или `both`
`limit`	integer	Нет	`100`	Максимальное число результатов (1–500)

Ответ

{
  "code": "JFK",
  "direction": "dep",
  "count": 3,
  "routes": [
    {
      "departure": "JFK",
      "arrival": "LHR",
      "airlines": ["American Airlines", "British Airways", "Delta Air Lines"],
      "km": 5555,
      "duration_min": 430
    }
  ]
}

Поле	Тип	Обязательный	Описание
`code`	string	Да	Повтор запрошенного кода аэропорта
`direction`	string	Да	Применённый фильтр направления
`count`	integer	Да	Число возвращённых строк маршрутов
`routes`	array	Да	Строки пар маршрутов (массив может быть пустым)

Элемент маршрута (`routes[]`)

Поле	Тип	Обязательный	Описание
`departure`	string	Да	Код аэропорта вылета (IATA или ICAO — как хранится)
`arrival`	string	Да	Код аэропорта прилёта
`airlines`	array	Да	Названия перевозчиков, обслуживающих маршрут
`km`	integer	Да	Расстояние по ортодромии в километрах
`duration_min`	integer	Да	Типичное блочное время в минутах

Клиентские типы

"""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 при построении карт хабов: ограничения по умолчанию сохраняют размер ответов приемлемым.

Смешение кодов аэропортов. Строки маршрутов могут использовать IATA или ICAO в зависимости от исходной записи — нормализуйте их через Аэропорты, прежде чем объединять с другими наборами данных.

Только расстояние по ортодромии. Для точного расстояния и пеленга между двумя известными точками см. Расстояние и пеленг.

Ответы с ошибками

Ошибки валидации 422: обзор маршрутов.

Authorization

x-api-key<token>

Your SkyLink licence key, for keys bought direct from skylinkapi.com.

In: header

Path Parameters

code*Code

Query Parameters

direction?Direction

'dep', 'arr', or 'both'

Default"both"

limit?Limit

Max results (default 100, max 500)

Default100

Range1 <= value <= 500

Response Body

`application/json`

curl -X GET "https://data.skylinkapi.com/v3.1/routes/airport/US"

null

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Запрос

Ответ

Элемент маршрута (routes[])

Клиентские типы

Интеграция

Примечания по реализации

Ответы с ошибками

Authorization

Path Parameters

Query Parameters

Response Body

200application/json

422application/json

На этой странице

Элемент маршрута (`routes[]`)

`application/json`

`application/json`