# Flughafenrouten

Alle bekannten Routen ab oder zu einem Flughafen auflisten — Fluggesellschaften, Entfernung und typische Blockzeit je Städtepaar.



Listet alle Routen ab oder zu einem bestimmten Flughafen auf. Liefert Routeneinträge mit Fluggesellschaften, Entfernung und Dauer — nützlich für Netzwerkansichten von Drehkreuzen und zur Anreicherung von Flugplänen.

<DocRequirements>
  <DocRequirementAuth />
</DocRequirements>

## Anfrage [#request]

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

| Parameter   | Typ     | Erforderlich | Standard | Beschreibung                                                                                     |
| ----------- | ------- | ------------ | -------- | ------------------------------------------------------------------------------------------------ |
| `code`      | string  | Ja           | -        | IATA-Code (3 Buchstaben, z. B. `MXP`) oder ICAO-Code (4 Buchstaben, z. B. `LIMC`) des Flughafens |
| `direction` | string  | Nein         | `both`   | `dep` (Abflüge), `arr` (Ankünfte) oder `both`                                                    |
| `limit`     | integer | Nein         | `100`    | Maximale Anzahl an Ergebnissen (1–500)                                                           |

## Antwort [#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
    }
  ]
}
```

| Feld        | Typ     | Erforderlich | Beschreibung                             |
| ----------- | ------- | ------------ | ---------------------------------------- |
| `code`      | string  | **Ja**       | Echo des angefragten Flughafencodes      |
| `direction` | string  | **Ja**       | Angewendeter Richtungsfilter             |
| `count`     | integer | **Ja**       | Anzahl der zurückgegebenen Routenzeilen  |
| `routes`    | array   | **Ja**       | Zeilen mit Routenpaaren (kann leer sein) |

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

### Routeneintrag (`routes[]`) [#route-item-routes]

| Feld           | Typ     | Erforderlich | Beschreibung                                            |
| -------------- | ------- | ------------ | ------------------------------------------------------- |
| `departure`    | string  | **Ja**       | Code des Abflughafens (IATA oder ICAO, wie gespeichert) |
| `arrival`      | string  | **Ja**       | Code des Ankunftsflughafens                             |
| `airlines`     | array   | **Ja**       | Namen der Fluggesellschaften, die die Route bedienen    |
| `km`           | integer | **Ja**       | Großkreisentfernung in Kilometern                       |
| `duration_min` | integer | **Ja**       | Typische Blockzeit in Minuten                           |

## Client-Typen [#client-types]

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

## Integration [#integration]

### Hinweise zur Implementierung [#implementation-notes]

**Paginierung.** Verwenden Sie `limit` beim Aufbau von Drehkreuzkarten; die Standardobergrenzen halten die Payloads überschaubar.

**Gemischte Flughafencodes.** Routenzeilen können je nach Quellzeile IATA- oder ICAO-Codes verwenden — normalisieren Sie sie über [Flughäfen](/docs/v31/airports), bevor Sie sie mit anderen Datensätzen zusammenführen.

**Nur Großkreisentfernung.** Für eine genaue Entfernung und Peilung zwischen zwei bekannten Punkten siehe [Entfernung & Peilung](/docs/v31/distance).

## Fehlerantworten [#error-responses]

Validierungsfehler `422`: [Übersicht Routen](/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;}]" />