# Flugbriefing
KI-gestütztes Vorflugbriefing für eine Route mit Wetter, NOTAMs und optionalen PIREPs als strukturiertes JSON oder in Textformaten.
Erstellen Sie ein **Vorflugbriefing** (standardisierte Zusammenfassung von Wetter, [NOTAMs](https://www.icao.int/safety/pages/notam-service-profiles.aspx) und betrieblichen Hinweisen für einen geplanten Flug) für ein ICAO-Paar aus Abflug- und Zielflughafen. Der Endpoint stellt [METAR](/docs/v31/weather-metar), [TAF](/docs/v31/weather-taf), [NOTAMs](/docs/v31/notams) und optional [PIREPs](/docs/v31/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](https://www.ibm.com/granite)**. Wenden Sie sich an SkyLink, wenn Sie Enterprise-Bereitstellungsoptionen über die Standardstufen von RapidAPI hinaus benötigen.
## Anfrage [#request]
| Parameter | Typ | Erforderlich | Standard | Beschreibung |
| ----------------- | ------- | ------------ | -------- | ------------------------------------------------------------- |
| `origin` | string | Ja | - | ICAO-Code des Abflughafens, z. B. `KJFK` |
| `destination` | string | Ja | - | ICAO-Code des Zielflughafens, z. B. `EGLL` |
| `include_weather` | boolean | Nein | `true` | METAR/TAF einbeziehen |
| `include_notams` | boolean | Nein | `true` | Aktive NOTAMs einbeziehen |
| `include_pireps` | boolean | Nein | `false` | Aktuelle PIREPs entlang der Route einbeziehen (höhere Latenz) |
| `format` | string | Nein | `json` | `json`, `markdown`, `plain_text` oder `html` |
Mindestens einer der Parameter `include_weather`, `include_notams` oder `include_pireps` sollte aktiviert bleiben.
## Antwort [#response]
### Strukturiertes JSON (`format=json`) [#structured-json-formatjson]
```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`) [#textmarkup-formatmarkdownplain_texthtml]
```json
{
"origin": "KJFK",
"destination": "EGLL",
"briefing": "# Flight Briefing\n\n- Route: KJFK -> EGLL\n- Weather: ..."
}
```
### Kernfelder [#core-fields]
| Feld | Typ | Format | Beschreibung |
| ----------------------- | --------- | --------- | ------------------------------------------------------ |
| `origin` | string | alle | ICAO-Code des Abflughafens |
| `destination` | string | alle | ICAO-Code des Zielflughafens |
| `summary` | string | `json` | KI-generierte betriebliche Zusammenfassung |
| `critical_restrictions` | string\[] | `json` | Einschränkungen mit hoher Priorität aus den Quelldaten |
| `origin_briefing` | object | `json` | Flughafenspezifischer Abschnitt für den Abflughafen |
| `destination_briefing` | object | `json` | Flughafenspezifischer Abschnitt für den Zielflughafen |
| `pireps` | array | `json` | Für die Route relevante PIREPs, sofern aktiviert |
| `briefing` | string | Text/HTML | Darstellungsfertiger Inhalt |
#### Flughafenbriefing (`origin_briefing` / `destination_briefing`) [#airport-briefing-origin_briefing--destination_briefing]
| Feld | Typ | Beschreibung |
| ------------------- | -------------- | --------------------------------------------------------------------------------------------- |
| `icao` | string | ICAO-Code des Flughafens |
| `weather.metar_raw` | string \| null | Aktueller METAR-Text oder `null`, wenn nicht verfügbar |
| `weather.taf_raw` | string \| null | Aktueller TAF-Text oder `null`, wenn nicht verfügbar |
| `notams` | array | Aktive NOTAM-Einträge — gleiche Struktur wie bei [NOTAMs](/docs/v31/notams#notam-item-notams) |
#### PIREPs entlang der Route (`pireps[]`) [#route-pireps-pireps]
Bei `include_pireps=true` folgt jedes Element dem Feldmodell des [PIREP-Berichts](/docs/v31/pireps#report-object-reports). Leer, wenn keine Meldungen den Routenkorridor schneiden.
Für ein herunterladbares PDF mit denselben Routeneingaben verwenden Sie [Briefing-PDF](/docs/v31/briefing-pdf) (`departure_icao` / `arrival_icao` entsprechen hier `origin` / `destination`).
## Client-Typen [#client-types]
## Integration [#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.
### Hinweise zur Implementierung [#implementation-notes]
**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 [#error-responses]
Gemeinsame Fehler finden Sie unter [Fehlerbehandlung](/docs/errors). Endpoint-spezifisch:
### 422 - ungültiger ICAO-Code oder nicht unterstütztes Format [#422---invalid-icao-or-unsupported-format]
```json
{
"detail": [
{
"type": "string_pattern_mismatch",
"loc": ["query", "format"],
"msg": "String should match pattern '^(json|markdown|plain_text|html)$'"
}
]
}
```
***
Siehe auch: [Briefing-PDF](/docs/v31/briefing-pdf) · [METAR](/docs/v31/weather-metar) · [NOTAMs](/docs/v31/notams)