# Einführung Dokumentation der SkyLink API — Luftfahrtdaten per REST über HTTPS, direkt oder über RapidAPI. Wetter, Flughäfen, Flüge, ADS-B, Karten, Warnungen und Integrationsleitfäden für v2, v3 und v3.1. SkyLink ist eine REST-API, die Luftfahrtdaten als JSON über HTTPS über das RapidAPI-Gateway bereitstellt. Sie abonnieren einmal, senden authentifizierte Anfragen an eine einzige Basis-URL und erhalten strukturierte Antworten zu Wetter, Flughäfen, Flügen, Live- und historischem Flugzeug-Tracking, Karten, Warnungen und mehr — ohne selbst Ingestion-Pipelines zu betreiben oder Datenfeeds zu pflegen. Diese Seite gibt Ihnen einen Überblick darüber, was die API abdeckt, welche Version Sie verwenden sollten und wo die einzelnen Themen dokumentiert sind. Einzelne Endpoints werden hier nicht beschrieben; diese finden Sie in den Referenzabschnitten der jeweiligen Version. ## Was abgedeckt ist [#whats-covered] * **Wetter** — Bodenbeobachtungen und Vorhersagen in Echtzeit, Warnmeldungen auf der Strecke (En-Route) und Höhenwinde für die USA * **Flughäfen** — Flughafenprofile, Start- und Landebahnen, Frequenzen, Funknavigationsanlagen (Navaids) und eine Suche mit mehreren Modi über mehr als 74.000 Flughäfen * **Flugbetrieb** — Live-Flugstatus, Abflug- und Ankunftsflugpläne, Entfernung und Peilung, KI-gestützte Preflight-Briefings * **[ADS-B](https://www.faa.gov/air_traffic/technology/adsb)-Tracking** — Live-Positionen von Luftfahrzeugen, angereichert um Kennzeichen, Typ und Fluggesellschaft * **Historisches [ADS-B](https://www.faa.gov/air_traffic/technology/adsb)** — archivierte Positionsdaten von Luftfahrzeugen; 90-Tage-Zeitfenster ab Pro, bis zu 365 Tage bei Business, Enterprise und den Legacy-Tarifen Ultra/Mega *(v3.1)* * **Luftfahrzeugsuche** — mehr als 615.000 Datensätze zu Luftfahrzeugen, abrufbar per Kennzeichen oder [ICAO24](https://en.wikipedia.org/wiki/ICAO_24-bit_address)-Hex-Adresse * **Flugplatzkarten** — Karten-PDFs für 91 Länder (Anflug, SID, STAR, Boden, allgemein) * **Warnungen und Hinweise** — [NOTAMs](https://www.icao.int/safety/pages/notam-service-profiles.aspx) und Verspätungsprogramme des [FAA NAS](https://www.faa.gov/about/office_org/headquarters_offices/ato/service_units/operations/at_delay_info) * **ML und KI** — Flugzeitschätzung, CO₂-Emissionen und KI-generierte Briefings * **Routen und Webhooks** — Auflösung von Routen anhand des Rufzeichens und Push-Benachrichtigungen bei Flugereignissen *(v3.1)* ## API-Versionen [#api-versions] SkyLink bietet drei aktive Versionen unter einem einzigen RapidAPI-Host an. Das Pfadpräfix (bzw. dessen Fehlen) bestimmt die Version — Sie wechseln zwischen den Versionen nicht den Host. | Version | Präfix auf RapidAPI | Status | | -------- | ---------------------------------------- | --------------------------------------------------- | | **v3.1** | *(keines — z. B. `/weather/metar/KJFK`)* | Neueste Version — empfohlen für alle neuen Projekte | | **v3** | `/v3` | Stabil, voller Funktionsumfang | | **v2** | `/v2` (in der Basis-URL) | Wird aus Gründen der Abwärtskompatibilität gepflegt | ``` https://skylink-api.p.rapidapi.com ``` Neue Integrationen sollten mit **v3.1** beginnen. Bestehende Nutzer von v3 oder v2 können direkt zur Übersicht ihrer Version springen. ## Aufbau dieser Dokumentation [#how-this-documentation-is-organised] | Abschnitt | Inhalt | | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | [Erste Schritte](/docs/getting-started) | Antrag auf FREE Trial, Abonnement über RapidAPI, Zugangsdaten, Schlüsselsicherheit, öffentliche Endpoints, erste Anfrage | | [Fehlerbehandlung](/docs/errors) | Aufbau von HTTP-Fehlern, Gateway- vs. API-Schicht, Regeln für Wiederholungsversuche | | [Rate Limits](/docs/rate-limits) | Tarifkontingente, Kontingent-Header, Preise für Mehrverbrauch, Pfadstufen für historisches ADS-B | | [v3.1-Referenz](/docs/v31/overview) | Vollständiges Endpoint-Verzeichnis der neuesten Version *(hier beginnen)* | | [v3-Referenz](/docs/v3/overview) | Verzeichnis der stabilen Endpoints | | [v2-Referenz](/docs/v2/overview) | Verzeichnis der Legacy-Endpoints | Jede Referenzseite eines Endpoints dokumentiert Pfad, Parameter, Aufbau der Antwort, Client-Typen, Hinweise zur Integration und endpointspezifische Fehlercodes. Plattformweite Fehler (Authentifizierung, Validierung, Rate Limits, Serverausfälle) werden einmalig unter [Fehlerbehandlung](/docs/errors) dokumentiert und von jeder Referenzseite aus verlinkt. **Neu bei SkyLink?** Beginnen Sie mit [Erste Schritte](/docs/getting-started) und öffnen Sie anschließend die [v3.1-API-Referenz](/docs/v31/overview). **Fehlgeschlagene Anfrage debuggen?** Siehe [Fehlerbehandlung](/docs/errors). **Kontingentgrenzen erreicht?** Siehe [Rate Limits](/docs/rate-limits).