Briefing-PDF

Laden Sie ein vollständiges Briefing zur Flugvorbereitung als PDF herunter — ein druckbares Dispatch-Paket für die Übergabe an die Crew oder zur Archivierung. Der Bericht kombiniert das Wetter am Abflug- und am Zielflughafen, NOTAMs, Warnmeldungen, PIREPs und eine KI-generierte Routenzusammenfassung für das ausgewählte ICAO-Paar.

Anders als alle anderen SkyLink-Endpoints liefert diese Operation application/pdf-Bytes — kein JSON. Speichern Sie den Antwort-Body direkt auf der Festplatte oder streamen Sie ihn an den Client.

Die Routenbeschreibung wird von Enterprise-Modellen von IBM Granite erzeugt — derselben Infrastruktur, die auch hinter Flug-Briefing steht. Wenden Sie sich an SkyLink, wenn Sie Optionen für Enterprise-Bereitstellungen über die Standardstufen von RapidAPI hinaus benötigen.

Anfrage

Antwort

Bei Erfolg antwortet die API mit PDF-Bytes.

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="briefing_EGLL_KJFK.pdf"

Das PDF enthält in der Regel METAR/TAF-Abschnitte für Abflug- und Zielflughafen, Zusammenfassungen aktiver NOTAMs, relevante PIREPs und Warnmeldungen sowie KI-generierte Routenhinweise.

Prüfen Sie Content-Type vor dem Speichern. Wenn der Server JSON statt application/pdf zurückgibt, parsen Sie den Body als Fehlerantwort — schreiben Sie ihn nicht in eine .pdf-Datei.

Client-Typen

"""Briefing PDF request model for /briefing/pdf."""from __future__ import annotationsfrom dataclasses import dataclass@dataclassclass BriefingPdfRequest:    departure_icao: str    arrival_icao: str    flight_number: str | None = None@dataclassclass BriefingPdfDownloadResult:    content_type: str    file_path: str    bytes: int

Integration

Laden Sie das PDF mit Anfrage-Timeouts herunter und schreiben Sie die Bytes in eine lokale Datei.

Das Beispiel zeigt TypeScript (Node.js Buffer), Python (binäres Schreiben) und curl (--output briefing.pdf).

import osfrom pathlib import Pathimport requestsBASE = "https://data.skylinkapi.com/v3.1"HEADERS = {    "x-api-key": os.getenv("SKYLINK_API_KEY", "YOUR_API_KEY")}def download_briefing_pdf(departure_icao: str, arrival_icao: str, *, output_path: str = "briefing.pdf") -> Path:    """Download a generated briefing PDF and save it to disk."""    r = requests.get(        f"{BASE}/briefing/pdf",        headers=HEADERS,        params={"departure_icao": departure_icao, "arrival_icao": arrival_icao},        timeout=(10, 30),    )    r.raise_for_status()    if "application/pdf" not in r.headers.get("Content-Type", ""):        raise RuntimeError("Expected PDF response")    path = Path(output_path)    path.write_bytes(r.content)    return pathif __name__ == "__main__":    path = download_briefing_pdf("KJFK", "KLAX")    print(f"Saved briefing PDF to {path.resolve()} ({path.stat().st_size:,} bytes)")

Hinweise zur Implementierung

Umgang mit Binärdaten. Verzweigen Sie anhand von Content-Type: application/pdf → Bytes speichern; application/json → Fehler parsen.

Vom Benutzer ausgelöste Downloads. Starten Sie diese Anfrage in Web-Clients über eine ausdrückliche Benutzeraktion (Klick auf eine Schaltfläche), damit sie zum Download-Verhalten des Browsers passt.

Caching. Erzeugte PDFs sind routen- und zeitspezifisch. Cache-Schlüssel sollten beide ICAO-Codes und den Zeitstempel der Erzeugung enthalten.

Fehlerantworten

Gemeinsame Plattformfehler finden Sie unter Fehlerbehandlung. Endpoint-spezifisch:

422 - fehlende oder ungültige ICAO-Eingabe

{
  "detail": [
    {
      "type": "missing",
      "loc": ["query", "departure_icao"],
      "msg": "Field required"
    }
  ]
}

curl -X GET "https://data.skylinkapi.com/v3.1/briefing/pdf?departure_icao=string&arrival_icao=string"

null

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Integrationsleitfäden

Siehe auch: Flug-Briefing · METAR · NOTAMs