# Briefing-PDF

Vollständiges Briefing-PDF zur Flugvorbereitung für Abflug- und Zielflughafen herunterladen – mit Wetter, Hinweisen, Warnmeldungen und Zusammenfassung.



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](https://www.icao.int/safety/pages/notam-service-profiles.aspx), Warnmeldungen, [PIREPs](https://www.aviationweather.gov/help/data/#pirep) 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](https://www.ibm.com/granite)** erzeugt — derselben Infrastruktur, die auch hinter [Flug-Briefing](/docs/v31/flight-briefing) steht. Wenden Sie sich an SkyLink, wenn Sie Optionen für Enterprise-Bereitstellungen über die Standardstufen von RapidAPI hinaus benötigen.

## Anfrage [#request]

<DocRequirements>
  <DocRequirementAuth />

  <DocRequirementIcao />
</DocRequirements>

<DocApiPath method="GET" path="/briefing/pdf" />

| Parameter        | Typ    | Erforderlich | Standard | Beschreibung                                      |
| ---------------- | ------ | ------------ | -------- | ------------------------------------------------- |
| `departure_icao` | string | Ja           | -        | ICAO-Code des Abflughafens, z. B. `EGLL`          |
| `arrival_icao`   | string | Ja           | -        | ICAO-Code des Zielflughafens, z. B. `KJFK`        |
| `flight_number`  | string | Nein         | -        | Optionale Beschriftung im PDF-Kopf, z. B. `BA117` |

## Antwort [#response]

Bei Erfolg antwortet die API mit PDF-Bytes.

```http
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](https://en.wikipedia.org/wiki/METAR)/[TAF](https://en.wikipedia.org/wiki/Terminal_aerodrome_forecast)-Abschnitte für Abflug- und Zielflughafen, Zusammenfassungen aktiver [NOTAMs](https://www.icao.int/safety/pages/notam-service-profiles.aspx), relevante [PIREPs](https://www.aviationweather.gov/help/data/#pirep) 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 [#client-types]

<DocClientTypes id="v31/briefing-pdf/pdf-types" />

## Integration [#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`).

<DocExample id="v31/briefing-pdf/pdf-fetch" />

### Hinweise zur Implementierung [#implementation-notes]

**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 [#error-responses]

Gemeinsame Plattformfehler finden Sie unter [Fehlerbehandlung](/docs/errors). Endpoint-spezifisch:

### 422 - fehlende oder ungültige ICAO-Eingabe [#422---missing-or-invalid-icao-input]

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

<APIPage document="&#x22;https://api.skylinkapi.com/v3.1/openapi.json&#x22;" operations="[{&#x22;path&#x22;:&#x22;/briefing/pdf&#x22;,&#x22;method&#x22;:&#x22;get&#x22;}]" />

### Integrationsleitfäden [#integration-guides]

| Leitfaden                                                                  | Inhalt                                                 |
| -------------------------------------------------------------------------- | ------------------------------------------------------ |
| [Flugstatus](/docs/v31/flight-status-integration)                          | Live-Status, Verspätungen, Abflugtafel                 |
| [Flugpläne](/docs/v31/schedules-integration)                               | Tafeln, Verspätungszahlen, Ankunfts-/Abflug-Dashboard  |
| [Entfernung](/docs/v31/distance-integration)                               | Großkreisentfernung, Routen-Ranking                    |
| [Flug-Briefing](/docs/v31/flight-briefing-integration)                     | KI-Zusammenfassung und wichtige NOTAMs                 |
| [Fehlerbehandlung](/docs/v31/flight-operations-integration-errors)         | 404, leere Tafeln, Wiederholungsversuche beim Briefing |
| [Caching & Monitoring](/docs/v31/flight-operations-integration-production) | TTLs und Hinweise zur Latenz                           |

***

Siehe auch: [Flug-Briefing](/docs/v31/flight-briefing) · [METAR](/docs/v31/weather-metar) · [NOTAMs](/docs/v31/notams)