Erste Schritte

Die SkyLink API wird über zwei Kanäle vertrieben: direkt bei uns (Abrechnung über unser eigenes Portal) und über den RapidAPI-Marktplatz. Beide liefern dieselben Daten — sie unterscheiden sich nur in der Basis-URL und im Authentifizierungs-Header. Sie schließen ein Abonnement ab (oder bewerben sich für eine Testphase), kopieren Ihren Schlüssel und senden HTTPS-Anfragen; jede Antwort ist JSON.

Wählen Sie Ihren Kanal

Wählen Sie den Kanal, über den Sie gekauft haben. Jede Basis-URL, jeder Header und jedes Codebeispiel in dieser Dokumentation richtet sich nach diesem Schalter, und Ihre Auswahl wird seitenübergreifend gespeichert.

Schritt 1 — Abonnieren und Zugangsdaten erhalten

FREE Trial

Der FREE Trial (1.000 Anfragen/Monat) ist nicht per Self-Service erhältlich. Bewerben Sie sich für den FREE Trial der SkyLink API — Bewerbungen werden wöchentlich geprüft; die meisten Teams erhalten innerhalb von 3–5 Werktagen eine Rückmeldung.

Kostenpflichtige Tarife

1. Öffnen Sie den SkyLink API Checkout und wählen Sie Basic oder Pro, mit monatlicher oder jährlicher Abrechnung (Tarife vergleichen).
2. Nach dem Checkout wird Ihr Lizenzschlüssel auf der Bestätigungsseite angezeigt und Ihnen per E-Mail zugesandt; er ist jederzeit in Ihrem Polar-Kundenportal verfügbar.

Jede authentifizierte Anfrage enthält einen Header:

Der Header ist die einzige akzeptierte Form — der Schlüssel wird nie aus einem Query-Parameter gelesen. Ein fehlender oder unbekannter Schlüssel liefert 401.

Die Version steht im Pfad. https://data.skylinkapi.com/v3.1/... für v3.1, /v3/... und /v2/... für die älteren Generationen.

Schlüsselsicherheit

• Betten Sie den Schlüssel niemals in mobile Apps, Browser-JavaScript oder öffentliche Repositories ein — er gewährt vollen API-Zugriff zulasten Ihres abgerechneten Kontingents.
• Speichern Sie ihn in einer Umgebungsvariablen (zum Beispiel SKYLINK_API_KEY) und injizieren Sie ihn zur Laufzeit serverseitig.
• Rotieren Sie den Schlüssel über Ihr Abrechnungs-Dashboard, falls er jemals offengelegt wird.

Öffentliche Endpoints (kein Schlüssel erforderlich)

OpenAPI-Spezifikationen und der Upstream-Health-Check werden von api.skylinkapi.com ausgeliefert — getrennt sowohl vom Daten-Host als auch vom RapidAPI-Proxy — und erfordern keinen Schlüssel:

Wichtig: Ein Aufruf von /health oder / auf einem Daten-Host liefert 404. Verwenden Sie api.skylinkapi.com ausschließlich für nicht authentifizierte Spezifikationen und Health-Checks.

Schritt 2 — Ihre erste Anfrage senden

Beispiel: ?parsed=true auf /weather/metar/KJFK.

Header: Schritt 1.

import osimport requestsBASE_URL = "https://data.skylinkapi.com/v3.1"HEADERS = {    "x-api-key": os.getenv(        "SKYLINK_API_KEY",        os.getenv("SKYLINK_API_KEY", os.getenv("SKYLINK_API_KEY", "YOUR_API_KEY")),    )}def get_metar(icao: str, parsed: bool = True) -> dict:    r = requests.get(        f"{BASE_URL}/weather/metar/{icao}",        headers=HEADERS,        params={"parsed": str(parsed).lower()},        timeout=(10, 15),    )    r.raise_for_status()    return r.json()if __name__ == "__main__":    import json    data = get_metar("KJFK")    print(json.dumps(data, indent=2, default=str))

Offizielle SDKs

Sie bevorzugen einen typisierten Client statt reinem HTTP? Beide offiziellen SDKs sind als skylink-api veröffentlicht, kapseln dieselben Endpoints, lesen Ihren Schlüssel aus der Umgebung und liefern typisierte Modelle zurück.

from skylink_api import SkyLink

with SkyLink() as sky:
    metar = sky.weather.metar("KJFK")
    traffic = sky.adsb.aircraft(lat=51.47, lon=-0.46, radius=75)
    status = sky.flight_status("BA117")

import { SkyLink } from "skylink-api";

// Direct channel — omit `provider` to use RapidAPI, the SDK's default.
const sky = new SkyLink({ provider: "direct", apiKey: process.env.SKYLINK_API_KEY });

const metar = await sky.weather.metar("KJFK", { parsed: true });
const flight = await sky.flightStatus("BA117");

Beide Kanäle bieten exakt dieselbe Methodenoberfläche — provider bestimmt nur die Basis-URL und welche Authentifizierungs-Header gesendet werden.

Der Python-Client erfordert Python 3.10+ und hängt von httpx und pydantic v2 ab. Der TypeScript-Client erfordert Node 20+ (oder eine beliebige Laufzeitumgebung mit globalem fetch — Bun, Deno, Cloudflare Workers, Vercel Edge), bringt keinerlei Laufzeitabhängigkeiten mit und verfügt über integrierte Wiederholungsversuche und Kontingent-Tracking. Der TypeScript-Client liest RAPIDAPI_KEY oder SKYLINK_API_KEY aus der Umgebung, wenn kein Schlüssel explizit übergeben wird.

Was Sie zurückerhalten

Eine erfolgreiche METAR-Antwort mit parsed=true sieht so aus:

{
  "raw": "METAR KJFK 062251Z 24017G23KT 10SM FEW060 FEW075 SCT110 BKN180 BKN250 28/17 A2974 RMK AO2 SLP072 T02830167 $",
  "icao": "KJFK",
  "airport_name": "John F. Kennedy International Airport",
  "timestamp": "2026-06-06T23:09:37Z",
  "parsed": {
    "time": "2026-06-07T00:51:00+02:00",
    "wind": { "direction": 240, "speed": 17, "gust": 23, "variable": [] },
    "visibility": { "value": 10, "repr": "10" },
    "flight_rules": "VFR",
    "temperature": 28,
    "dewpoint": 17,
    "altimeter": 29.74
  }
}

parsed.flight_rules ist die aus Wolkenuntergrenze und Sichtweite abgeleitete Flugwetterkategorie: VFR (Sichtflugregeln), MVFR (marginales VFR), IFR (Instrumentenflugregeln) oder LIFR (niedriges IFR). Vollständige Feldtabellen und Regeln zur Nullbarkeit: METAR-Referenz.

Bei parsed=false (oder ohne Angabe) fehlt der Schlüssel parsed — Sie erhalten nur raw, icao, airport_name und timestamp.

Nächste Schritte

• v3.1 API-Referenz — vollständiger Endpoint-Index (hier beginnen)
• Fehlerbehandlung — Fehlerformate, Statuscodes, Regeln für Wiederholungsversuche
• Rate Limits — Tarife, Kontingent-Header, Pfadstufen für historische ADS-B-Daten
• v3 API-Referenz — stabile Version
• v2 API-Referenz — Legacy-Version
• Python SDK · TypeScript SDK — typisierte Clients