Flugbriefing

Erstellen Sie ein Vorflugbriefing (standardisierte Zusammenfassung von Wetter, NOTAMs und betrieblichen Hinweisen für einen geplanten Flug) für ein ICAO-Paar aus Abflug- und Zielflughafen. Der Endpoint stellt METAR, TAF, NOTAMs und optional PIREPs zusammen und gibt anschließend entweder strukturiertes JSON oder darstellungsfertigen Text zurück.

Dieses Briefing ist unterstützend — es ersetzt weder die offizielle Dispatch-Freigabe noch Veröffentlichungen der Behörden. Zeigen Sie in Anwendungen für Endnutzer einen gut sichtbaren Haftungshinweis an.

Enterprise-KI-Endpoints (einschließlich dieses Briefings) laufen auf einer Infrastruktur von IBM Granite. Wenden Sie sich an SkyLink, wenn Sie Enterprise-Bereitstellungsoptionen über die Standardstufen von RapidAPI hinaus benötigen.

Anfrage

Mindestens einer der Parameter include_weather, include_notams oder include_pireps sollte aktiviert bleiben.

Antwort

Strukturiertes JSON (format=json)

{
  "origin": "KJFK",
  "destination": "EGLL",
  "summary": "VFR at KJFK, MVFR at EGLL with light rain and wet-runway delay risk.",
  "critical_restrictions": [],
  "origin_briefing": {
    "icao": "KJFK",
    "weather": {
      "metar_raw": "KJFK 151856Z 31008KT 10SM FEW250 08/M06 A3012 RMK AO2 SLP204",
      "taf_raw": "TAF KJFK 151730Z 1518/1624 30010KT P6SM FEW250"
    },
    "notams": []
  },
  "destination_briefing": {
    "icao": "EGLL",
    "weather": {
      "metar_raw": "EGLL 151850Z 22012KT 4000 -RA BKN030 07/05 Q1009",
      "taf_raw": "TAF EGLL 151658Z 1518/1624 22012KT 6000 -RA BKN030"
    },
    "notams": []
  },
  "pireps": []
}

Text/Markup (format=markdown|plain_text|html)

{
  "origin": "KJFK",
  "destination": "EGLL",
  "briefing": "# Flight Briefing\n\n- Route: KJFK -> EGLL\n- Weather: ..."
}

Kernfelder

Flughafenbriefing (origin_briefing / destination_briefing)

PIREPs entlang der Route (pireps[])

Bei include_pireps=true folgt jedes Element dem Feldmodell des PIREP-Berichts. Leer, wenn keine Meldungen den Routenkorridor schneiden.

Für ein herunterladbares PDF mit denselben Routeneingaben verwenden Sie Briefing-PDF (departure_icao / arrival_icao entsprechen hier origin / destination).

Client-Typen

"""Flight briefing models for /briefing/flight."""from __future__ import annotationsfrom dataclasses import dataclass, fieldfrom typing import Any@dataclassclass FlightBriefingRequest:    origin: str    destination: str    include_weather: bool = True    include_notams: bool = True    include_pireps: bool = False    format: str = "json"@dataclassclass FlightBriefingStructuredResponse:    origin: str    destination: str    summary: str    critical_restrictions: list[str] = field(default_factory=list)    origin_briefing: dict[str, Any] = field(default_factory=dict)    destination_briefing: dict[str, Any] = field(default_factory=dict)    pireps: list[Any] = field(default_factory=list)@dataclassclass FlightBriefingTextResponse:    origin: str    destination: str    briefing: str

Integration

Rufen Sie den Endpoint mit format=json auf, verwenden Sie explizite Timeouts und bilden Sie die Ausgabe auf die Nutzdaten einer Dispatch-Karte ab.

import osimport requestsBASE = "https://data.skylinkapi.com/v3.1"HEADERS = {    "x-api-key": os.getenv("SKYLINK_API_KEY", "YOUR_API_KEY")}def fetch_flight_briefing(origin: str, destination: str) -> dict:    """Generate an AI-powered briefing for a route."""    r = requests.get(        f"{BASE}/briefing/flight",        headers=HEADERS,        params={            "origin": origin,            "destination": destination,            "include_weather": "true",            "include_notams": "true",            "include_pireps": "false",            "format": "json",        },        timeout=(10, 25),    )    r.raise_for_status()    return r.json()if __name__ == "__main__":    import json    briefing = fetch_flight_briefing("KJFK", "KLAX")    print(json.dumps(briefing, indent=2, default=str)[:4000])

Hinweise zur Implementierung

Abwägung bei der Latenz. include_pireps=true fügt einen räumlichen Abfrageschritt hinzu und erhöht die Antwortzeit spürbar. Lassen Sie den Parameter in UI-Modi mit schneller Aktualisierung deaktiviert.

Formatstrategie. Verwenden Sie json für Anwendungslogik und typisiertes Rendering. Verwenden Sie markdown / html nur für menschenlesbare Exporte.

Betrieblicher Haftungshinweis. Die KI-Zusammenfassung dient der Unterstützung und ist keine maßgebliche Flugdispatch-Dokumentation — weisen Sie in Ihrem Produkt darauf hin.

Fehlerantworten

Gemeinsame Fehler finden Sie unter Fehlerbehandlung. Endpoint-spezifisch:

422 - ungültiger ICAO-Code oder nicht unterstütztes Format

{
  "detail": [
    {
      "type": "string_pattern_mismatch",
      "loc": ["query", "format"],
      "msg": "String should match pattern '^(json|markdown|plain_text|html)$'"
    }
  ]
}

curl -X GET "https://data.skylinkapi.com/v3.1/briefing/flight?origin=stri&destination=stri"

{
  "origin": "KJFK",
  "destination": "EGLL",
  "summary": "VFR conditions at KJFK with clear skies and light winds. EGLL is MVFR with broken clouds at 3,000 feet and visibility 4 statute miles in light rain. No critical restrictions at either airport. Expect minor delays at EGLL due to wet runway conditions.",
  "critical_restrictions": [],
  "origin_briefing": {
    "icao": "KJFK",
    "weather": {
      "metar_raw": "KJFK 151856Z 31008KT 10SM FEW250 08/M06 A3012 RMK AO2 SLP204",
      "taf_raw": "TAF KJFK 151730Z 1518/1624 31010KT P6SM FEW250",
      "conditions": "VFR. Visibility 10 statute miles. Few clouds at 25,000 feet. Wind from 310 degrees at 8 knots. Temperature 8°C, dewpoint -6°C. Altimeter 30.12 inHg."
    },
    "notams": [
      {
        "title": "Taxiway B closed",
        "description": "Taxiway B between A and C is closed for maintenance. Use Taxiway D as alternate. Valid until Feb 20 at 18:00 UTC.",
        "affected": "TWY B",
        "notam_id": "01/234"
      }
    ]
  },
  "destination_briefing": {
    "icao": "EGLL",
    "weather": {
      "metar_raw": "EGLL 151850Z AUTO 24012KT 4000 -RA BKN030 06/04 Q1023",
      "taf_raw": "TAF EGLL 151700Z 1518/1624 24015KT 5000 -RA BKN025",
      "conditions": "MVFR. Visibility 4,000 meters (2.5 statute miles) in light rain. Broken clouds at 3,000 feet. Wind from 240 degrees at 12 knots. Temperature 6°C, dewpoint 4°C. Altimeter 1023 hPa."
    },
    "notams": []
  },
  "data_included": [
    "metar",
    "taf",
    "notams"
  ],
  "disclaimer": "This briefing is AI-generated and for informational purposes only. Always verify with official sources before flight operations."
}

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

Siehe auch: Briefing-PDF · METAR · NOTAMs