Save up to 17% with yearly billing

See pricing

Routenpaare

Fragen Sie Statistiken für ein bestimmtes Paar aus Abflug- und Zielort ab. Liefert Fluggesellschaften, Großkreisentfernung (km) und die typische Blockzeit (Gate-to-Gate-Dauer der Route). Die Ergebnisse sind nach der Anzahl der Fluggesellschaften sortiert. Geben Sie mindestens einen der Parameter departure oder arrival an, um aussagekräftige Ergebnismengen zu erhalten.

Voraussetzungen

Auth
x-api-key bei jeder Anfrage (Direktabonnement). Mehr erfahren →

Anfrage

GEThttps://data.skylinkapi.com/v3.1/routes/pairs
ParameterTypErforderlichStandardBeschreibung
departurestringNein-IATA- oder ICAO-Code des Abflughafens
arrivalstringNein-IATA- oder ICAO-Code des Zielflughafens
limitintegerNein50Maximale Anzahl an Ergebnissen (1–500)

Antwort

{
  "count": 1,
  "routes": [
    {
      "departure": "JFK",
      "arrival": "LHR",
      "airlines": ["American Airlines", "British Airways", "Delta Air Lines", "Virgin Atlantic"],
      "km": 5555,
      "duration_min": 430
    }
  ]
}
FeldTypErforderlichBeschreibung
countintegerJaAnzahl der zurückgegebenen Routenzeilen
routesarrayJaGleiche Struktur der Routeneinträge wie bei Flughafenrouten

Client-Typen

"""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

Integration

Hinweise zur Implementierung

Beide Codes bekannt. Verwenden Sie diesen Endpoint, wenn Sie die Codes des Abflug- und des Zielflughafens bereits kennen und Kontext zu Fluggesellschaften und Flugdauer benötigen — das ist schneller, als alle Routen eines Flughafens aufzulisten.

Paginierung. Verwenden Sie limit bei breit gefassten Teiltreffern; die Standardobergrenzen halten die Antwortgrößen überschaubar.

Fehlerantworten

Validierungsfehler 422: Routen-Übersicht.

GET
/routes/pairs
x-api-key<token>

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

In: header

Query Parameters

departure?|

Filter by departure airport (IATA or ICAO)

arrival?|

Filter by arrival airport (IATA or ICAO)

limit?Limit

Max results (default 50, max 500)

Default50
Range1 <= value <= 500

Response 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": {}
    }
  ]
}