Save up to 17% with yearly billing

See pricing

Rufzeichen → Route

Ordnen Sie ein Live-Rufzeichen (das über ADS-B gesendete Rufzeichen eines Flugs, z. B. BAW178) Abflug- und Zielflughafen zu. Findet SkyLink eine exakte Übereinstimmung für das Rufzeichen, enthält die Antwort departure_icao und arrival_icao mit confidence: "high". Fehlt das exakte Rufzeichen, greift die API auf eine Routenliste auf Ebene der Fluggesellschaft im Array routes zurück (gleiche Struktur wie bei den Flughafenrouten).

Voraussetzungen

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

Anfrage

GEThttps://data.skylinkapi.com/v3.1/routes/callsign/{callsign}
ParameterTypErforderlichBeschreibung
callsignstringJaPfadparameter für das Rufzeichen des Flugs — Kennung der Fluggesellschaft plus numerisches Suffix, z. B. BAW178

Antwort

Beispiel für eine exakte Übereinstimmung:

{
  "callsign": "BAW178",
  "callsign_prefix": "BAW",
  "airline_code": "BAW",
  "departure_icao": "KJFK",
  "arrival_icao": "EGLL",
  "airports": ["KJFK", "EGLL"],
  "confidence": "high",
  "source": "vrs"
}

Beispiel für einen Fallback (keine exakte Zeile für das Rufzeichen — es werden Routen auf Ebene der Fluggesellschaft zurückgegeben):

{
  "callsign": "BAW999",
  "callsign_prefix": "BAW",
  "airline_code": "BAW",
  "departure_icao": null,
  "arrival_icao": null,
  "airports": null,
  "confidence": "low",
  "source": "vrs",
  "routes": [
    {
      "departure": "LHR",
      "arrival": "JFK",
      "airlines": ["British Airways"],
      "km": 5555,
      "duration_min": 430
    }
  ]
}
FeldTypErforderlichNull?Beschreibung
callsignstringJaNieEcho des angefragten Rufzeichens
callsign_prefixstringJaNieAus dem Rufzeichen extrahiertes ICAO-Präfix der Fluggesellschaft
airline_codestringJaNieAufgelöster ICAO-Code der Fluggesellschaft
departure_icaostringBei exakter ÜbereinstimmungJa (Fallback)ICAO-Code des Abflughafens, sofern bekannt
arrival_icaostringBei exakter ÜbereinstimmungJa (Fallback)ICAO-Code des Zielflughafens, sofern bekannt
airportsarrayBei exakter ÜbereinstimmungJa (Fallback)Geordnete ICAO-Codes [departure, arrival]
confidencestringJaNieQualität der Übereinstimmung — high bei exakten Treffern für das Rufzeichen
sourcestringJaNieOpaker Bezeichner der Routendatenquelle aus der API
routesarrayBeim FallbackJa (exakte Übereinstimmung)Routenliste auf Ebene der Fluggesellschaft, wenn keine exakte Zeile für das Rufzeichen existiert — gleiche Elementstruktur wie bei den Flughafenrouten

Wichtig: Behandeln Sie confidence: "high" als zuverlässiges Städtepaar mit departure_icao/arrival_icao. Ist nur routes[] vorhanden, zeigen Sie die oberste Route als Vorschlag an und lassen Sie den Nutzer bestätigen — gehen Sie nicht davon aus, dass die erste Zeile dem aktiven Flug entspricht.

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

Lösen Sie ein Live-ADS-B-Rufzeichen in eine Schätzung von Abflug- und Zielflughafen für Karten-Overlays und Flugkarten auf.

Das folgende Beispiel speichert Rufzeichen-Abfragen 24 Stunden im Cache, da sich zugewiesene Routen selten ändern. Jede Anfrage verwendet explizite Timeouts (10 s Verbindungsaufbau / 15 s Lesen). Die Hilfsfunktion normalisiert sowohl Antworten mit exakter Übereinstimmung als auch Fallback-Antworten in ein einheitliches RouteGuess-Objekt für den UI-Code.

import osimport timefrom dataclasses import dataclassimport requestsHEADERS = {    "x-api-key": os.getenv("SKYLINK_API_KEY", "YOUR_API_KEY")}BASE = "https://data.skylinkapi.com/v3.1"CACHE: dict[str, tuple[dict, float]] = {}ROUTE_TTL = 86_400  # 24 h@dataclassclass RouteGuess:    callsign: str    departure: str | None    arrival: str | None    confidence: str    source: strdef fetch_route_by_callsign(callsign: str) -> dict:    callsign = callsign.upper().strip()    key = f"route:callsign:{callsign}"    cached = CACHE.get(key)    if cached and time.time() < cached[1]:        return cached[0]    try:        r = requests.get(            f"{BASE}/routes/callsign/{callsign}",            headers=HEADERS,            timeout=(10, 15),        )    except requests.Timeout as exc:        raise RuntimeError(f"SkyLink timeout resolving route for {callsign}") from exc    r.raise_for_status()    data = r.json()    CACHE[key] = (data, time.time() + ROUTE_TTL)    return datadef route_guess(callsign: str) -> RouteGuess | None:    data = fetch_route_by_callsign(callsign)    dep = data.get("departure_icao")    arr = data.get("arrival_icao")    if not dep and not arr:        routes = data.get("routes") or []        if not routes:            return None        top = routes[0]        dep, arr = top.get("departure"), top.get("arrival")    return RouteGuess(        callsign=data.get("callsign", callsign),        departure=dep,        arrival=arr,        confidence=data.get("confidence", "unknown"),        source=data.get("source", "vrs"),    )if __name__ == "__main__":    import json    from dataclasses import asdict    guess = route_guess("BAW178")    print(json.dumps(asdict(guess), indent=2) if guess else "Route not found")

Hinweise zur Implementierung

Normalisierung der Codes. Wandeln Sie Rufzeichen vor der Abfrage in Großbuchstaben um (baw178 → BAW178). Entfernen Sie Leerzeichen aus ADS-B-Feeds.

Gemischte Flughafencodes. Routenzeilen können je nach Quellzeile IATA- oder ICAO-Codes verwenden — normalisieren Sie diese über Flughäfen, bevor Sie sie mit anderen Datensätzen verknüpfen.

Fehlerantworten

Validierungsfehler 422: Übersicht Routen.

GET
/routes/callsign/{callsign}
x-api-key<token>

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

In: header

Path Parameters

callsign*Callsign

Response Body

application/json

application/json

curl -X GET "https://data.skylinkapi.com/v3.1/routes/callsign/UAL100"
{
  "callsign": "RYR86UK",
  "callsign_prefix": "RYR",
  "airline_code": "RYR",
  "airline_iata": "FR",
  "departure_icao": "LHBP",
  "departure_iata": "BUD",
  "arrival_icao": "LIME",
  "arrival_iata": "BGY",
  "airports": [
    "LHBP",
    "LIME"
  ],
  "confidence": "high",
  "source": "vrs"
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}