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

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



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

<DocRequirements>
  <DocRequirementAuth />
</DocRequirements>

## Запрос [#request]

<DocApiPath method="GET" path="/routes/airport/{code}" />

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

## Ответ [#response]

```json
{
  "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   | **Да**       | Строки пар маршрутов (массив может быть пустым) |

<a id="route-item-routes" />

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

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

## Клиентские типы [#client-types]

<DocClientTypes id="v31/routes/routes-types" />

## Интеграция [#integration]

### Примечания по реализации [#implementation-notes]

**Пагинация.** Используйте `limit` при построении карт хабов: ограничения по умолчанию сохраняют размер ответов приемлемым.

**Смешение кодов аэропортов.** Строки маршрутов могут использовать IATA или ICAO в зависимости от исходной записи — нормализуйте их через [Аэропорты](/docs/v31/airports), прежде чем объединять с другими наборами данных.

**Только расстояние по ортодромии.** Для точного расстояния и пеленга между двумя известными точками см. [Расстояние и пеленг](/docs/v31/distance).

## Ответы с ошибками [#error-responses]

Ошибки валидации `422`: [обзор маршрутов](/docs/v31/routes#error-responses).

<APIPage document="&#x22;https://api.skylinkapi.com/v3.1/openapi.json&#x22;" operations="[{&#x22;path&#x22;:&#x22;/routes/airport/{code}&#x22;,&#x22;method&#x22;:&#x22;get&#x22;}]" />