# Полётный брифинг
Предполётный брифинг по маршруту на базе ИИ: погода, NOTAM и (опционально) PIREP в структурированном JSON или текстовых форматах.
Формируйте **предполётный брифинг** (стандартизированную сводку погоды, [NOTAM](https://www.icao.int/safety/pages/notam-service-profiles.aspx) и операционных извещений для планируемого полёта) для пары аэропортов вылета и назначения по кодам ICAO. Эндпоинт объединяет [METAR](/docs/v31/weather-metar), [TAF](/docs/v31/weather-taf), [NOTAM](/docs/v31/notams) и (опционально) [PIREP](/docs/v31/pireps), а затем возвращает либо структурированный JSON, либо готовый к отображению текст.
Этот брифинг носит **вспомогательный** характер — он не заменяет официальное разрешение на вылет от службы диспетчеризации или публикации уполномоченных органов. Показывайте заметное предупреждение об этом в приложениях для пользователей.
**ИИ-эндпоинты уровня Enterprise** (включая этот брифинг) работают на инфраструктуре **[IBM Granite](https://www.ibm.com/granite)**. Свяжитесь со SkyLink, чтобы узнать о вариантах корпоративного развёртывания помимо стандартных тарифов RapidAPI.
## Запрос [#request]
| Параметр | Тип | Обязательный | По умолчанию | Описание |
| ----------------- | ------- | ------------ | ------------ | ------------------------------------------------------------- |
| `origin` | string | Да | - | ICAO-код аэропорта вылета, например `KJFK` |
| `destination` | string | Да | - | ICAO-код аэропорта назначения, например `EGLL` |
| `include_weather` | boolean | Нет | `true` | Включить METAR/TAF |
| `include_notams` | boolean | Нет | `true` | Включить действующие NOTAM |
| `include_pireps` | boolean | Нет | `false` | Включить недавние PIREP вдоль маршрута (увеличивает задержку) |
| `format` | string | Нет | `json` | `json`, `markdown`, `plain_text` или `html` |
Хотя бы один из параметров `include_weather`, `include_notams` или `include_pireps` должен оставаться включённым.
## Ответ [#response]
### Структурированный 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": []
}
```
### Текст и разметка (`format=markdown|plain_text|html`) [#textmarkup-formatmarkdownplain_texthtml]
```json
{
"origin": "KJFK",
"destination": "EGLL",
"briefing": "# Flight Briefing\n\n- Route: KJFK -> EGLL\n- Weather: ..."
}
```
### Основные поля [#core-fields]
| Поле | Тип | Формат | Описание |
| ----------------------- | --------- | ---------- | -------------------------------------------------- |
| `origin` | string | все | ICAO-код аэропорта вылета |
| `destination` | string | все | ICAO-код аэропорта назначения |
| `summary` | string | `json` | Операционная сводка, сгенерированная ИИ |
| `critical_restrictions` | string\[] | `json` | Ограничения высокого приоритета из исходных данных |
| `origin_briefing` | object | `json` | Раздел по аэропорту вылета |
| `destination_briefing` | object | `json` | Раздел по аэропорту назначения |
| `pireps` | array | `json` | PIREP, относящиеся к маршруту, если включены |
| `briefing` | string | текст/html | Готовое к отображению содержимое |
#### Брифинг по аэропорту (`origin_briefing` / `destination_briefing`) [#airport-briefing-origin_briefing--destination_briefing]
| Поле | Тип | Описание |
| ------------------- | -------------- | ----------------------------------------------------------------------------------------------- |
| `icao` | string | ICAO-код аэропорта |
| `weather.metar_raw` | string \| null | Текст последней сводки METAR или `null`, если недоступен |
| `weather.taf_raw` | string \| null | Текст последнего TAF или `null`, если недоступен |
| `notams` | array | Действующие записи NOTAM — та же структура, что и в [NOTAM](/docs/v31/notams#notam-item-notams) |
#### PIREP по маршруту (`pireps[]`) [#route-pireps-pireps]
При `include_pireps=true` каждый элемент соответствует модели полей [донесения PIREP](/docs/v31/pireps#report-object-reports). Массив пуст, если ни одно донесение не пересекает коридор маршрута.
Чтобы получить PDF для скачивания с теми же входными данными маршрута, используйте [Брифинг в PDF](/docs/v31/briefing-pdf) (`departure_icao` / `arrival_icao` соответствуют здесь `origin` / `destination`).
## Клиентские типы [#client-types]
## Интеграция [#integration]
Выполняйте вызов с `format=json`, задавайте явные тайм-ауты и преобразуйте результат в данные для карточки диспетчеризации.
### Примечания по реализации [#implementation-notes]
**Компромисс по задержке.** `include_pireps=true` добавляет этап пространственного поиска и заметно увеличивает время ответа. Отключайте этот параметр в режимах интерфейса с быстрым обновлением.
**Выбор формата.** Используйте `json` для логики приложения и типизированной отрисовки. Используйте `markdown` / `html` только для экспорта в удобочитаемом виде.
**Операционное предупреждение.** Сводка ИИ носит вспомогательный характер и не является официальной документацией для диспетчеризации рейса — сообщайте об этом в своём продукте.
## Ответы с ошибками [#error-responses]
Общие ошибки см. в разделе [Обработка ошибок](/docs/errors). Ошибки, специфичные для эндпоинта:
### 422 - недопустимый код ICAO или неподдерживаемый формат [#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)$'"
}
]
}
```
***
См. также: [Брифинг в PDF](/docs/v31/briefing-pdf) · [METAR](/docs/v31/weather-metar) · [NOTAM](/docs/v31/notams)