# PDF-брифинг

Загрузка полного предполётного брифинга в PDF для аэропортов вылета и прилёта: погода, извещения, предупреждения и сводка.



Загрузите полный предполётный брифинг в виде **PDF** — **диспетчерский пакет** для печати, передачи экипажу или архивирования. Отчёт объединяет погоду в аэропортах вылета и прилёта, [NOTAM](https://www.icao.int/safety/pages/notam-service-profiles.aspx), предупреждения, [PIREP](https://www.aviationweather.gov/help/data/#pirep) и сгенерированную ИИ сводку по маршруту для выбранной пары кодов ICAO.

В отличие от всех остальных эндпоинтов SkyLink, эта операция возвращает **байты `application/pdf`**, а не JSON. Сохраняйте тело ответа напрямую на диск или передавайте его клиенту потоком.

Описание маршрута генерируется корпоративными моделями **[IBM Granite](https://www.ibm.com/granite)** — на той же инфраструктуре работает [Брифинг полёта](/docs/v31/flight-briefing). Свяжитесь с SkyLink, чтобы узнать о вариантах корпоративного развёртывания помимо стандартных тарифов RapidAPI.

## Запрос [#request]

<DocRequirements>
  <DocRequirementAuth />

  <DocRequirementIcao />
</DocRequirements>

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

| Параметр         | Тип    | Обязательный | По умолчанию | Описание                                                 |
| ---------------- | ------ | ------------ | ------------ | -------------------------------------------------------- |
| `departure_icao` | string | Да           | -            | Код ICAO аэропорта вылета, например `EGLL`               |
| `arrival_icao`   | string | Да           | -            | Код ICAO аэропорта прилёта, например `KJFK`              |
| `flight_number`  | string | Нет          | -            | Необязательная подпись в заголовке PDF, например `BA117` |

## Ответ [#response]

При успешном выполнении API возвращает байты PDF.

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

PDF обычно содержит разделы [METAR](https://en.wikipedia.org/wiki/METAR)/[TAF](https://en.wikipedia.org/wiki/Terminal_aerodrome_forecast) для аэропортов вылета и прилёта, сводки активных [NOTAM](https://www.icao.int/safety/pages/notam-service-profiles.aspx), актуальные [PIREP](https://www.aviationweather.gov/help/data/#pirep) и предупреждения, а также сгенерированные ИИ заметки по маршруту.

**Проверяйте `Content-Type` перед сохранением.** Если сервер вернул JSON вместо `application/pdf`, разберите тело как ответ с ошибкой — не записывайте его в файл `.pdf`.

## Клиентские типы [#client-types]

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

## Интеграция [#integration]

Загрузите PDF с тайм-аутами запроса и запишите байты в локальный файл.

Пример показывает TypeScript (`Buffer` в Node.js), Python (двоичная запись) и curl (`--output briefing.pdf`).

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

### Примечания по реализации [#implementation-notes]

**Работа с двоичными данными.** Ветвитесь по `Content-Type`: `application/pdf` → сохранить байты; `application/json` → разобрать ошибку.

**Загрузка по действию пользователя.** В веб-клиентах запускайте этот запрос по явному действию пользователя (нажатию кнопки), чтобы соответствовать поведению загрузок в браузере.

**Кэширование.** Сгенерированные PDF зависят от маршрута и времени. Ключи кэша должны включать оба кода ICAO и метку времени генерации.

## Ответы с ошибками [#error-responses]

Общие ошибки платформы см. в разделе [Обработка ошибок](/docs/errors). Специфичные для эндпоинта:

### 422 — отсутствующий или некорректный код ICAO [#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;}]" />

### Руководства по интеграции [#integration-guides]

| Руководство                                                                    | Содержание                                          |
| ------------------------------------------------------------------------------ | --------------------------------------------------- |
| [Статус рейса](/docs/v31/flight-status-integration)                            | Статус в реальном времени, задержки, табло вылетов  |
| [Расписания](/docs/v31/schedules-integration)                                  | Табло, подсчёт задержек, дашборд прилётов и вылетов |
| [Расстояние](/docs/v31/distance-integration)                                   | Расстояние по ортодромии, ранжирование маршрутов    |
| [Брифинг полёта](/docs/v31/flight-briefing-integration)                        | ИИ-сводка и ключевые NOTAM                          |
| [Обработка ошибок](/docs/v31/flight-operations-integration-errors)             | 404, пустые табло, повторные попытки брифинга       |
| [Кэширование и мониторинг](/docs/v31/flight-operations-integration-production) | TTL и заметки о задержке ответа                     |

***

См. также: [Брифинг полёта](/docs/v31/flight-briefing) · [METAR](/docs/v31/weather-metar) · [NOTAM](/docs/v31/notams)