# Вебхуки и оповещения

Push-уведомления об изменении статуса рейса: создание, просмотр, включение, отключение и удаление подписок на вебхуки по номеру рейса.



Вебхуки доставляют push-уведомления, когда меняется статус отслеживаемого рейса. События берутся из того же live-потока статусов рейсов, что и [Статус рейса](/docs/v31/flight-status), — ваш сервер получает HTTP-колбэки `POST` вместо того, чтобы опрашивать API.

<DocRequirements>
  <DocRequirementAuth />

  <DocRequirement label="Тариф" href="/docs/rate-limits#plans">
    Pro, Ultra или Mega — на тарифе BASIC создавать вебхуки нельзя
  </DocRequirement>
</DocRequirements>

| Тариф | Макс. число активных вебхуков |
| ----- | ----------------------------- |
| BASIC | 0 (создание отклоняется)      |
| PRO   | 1                             |
| ULTRA | 3                             |
| MEGA  | 10                            |

Статус опрашивается каждые **5 минут**. Подписки автоматически отключаются после **10 неудачных доставок подряд**. Подробнее о тарифах: [Ограничения частоты запросов](/docs/rate-limits).

| Эндпоинт                        | Страница                                                            | Когда использовать                                    |
| ------------------------------- | ------------------------------------------------------------------- | ----------------------------------------------------- |
| `POST /webhooks`                | [Подписки](/docs/v31/webhooks-subscriptions#create-webhook)         | Зарегистрировать URL колбэка для рейса                |
| `GET /webhooks`                 | [Подписки](/docs/v31/webhooks-subscriptions#list-webhooks)          | Получить список подписок для вашего API-ключа         |
| `PATCH /webhooks/{webhook_id}`  | [Подписки](/docs/v31/webhooks-subscriptions#enable-disable-webhook) | Приостановить или возобновить без удаления            |
| `DELETE /webhooks/{webhook_id}` | [Подписки](/docs/v31/webhooks-subscriptions#delete-webhook)         | Безвозвратно удалить подписку                         |
| `GET /webhooks/events`          | [Типы событий](/docs/v31/webhooks-subscriptions#event-types)        | Узнать поддерживаемые значения `event_types`          |
| *(входящий)*                    | [Доставка колбэков](/docs/v31/webhooks-callback)                    | Тело HTTP-запроса `POST`, которое получает ваш сервер |

**Вебхуки или опрос.** Для оповещений о смене гейта вебхуков с интервалом опроса 5 минут обычно достаточно, и это намного дешевле, чем опрашивать [Статус рейса](/docs/v31/flight-status) чаще раза в минуту. Используйте опрос, когда нужны запросы по требованию без зарегистрированного URL колбэка.

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

Общие ошибки платформы: [Обработка ошибок](/docs/errors). Ограничение по тарифу:

### 403 — тариф не включает вебхуки [#403--plan-does-not-include-webhooks]

```json
{
  "detail": "Webhook subscriptions require PRO, ULTRA, or MEGA plan (current plan: BASIC)."
}
```

Ошибки, специфичные для эндпоинтов (404 при проверке владельца, доставка колбэков), описаны на страницах [Подписки](/docs/v31/webhooks-subscriptions) и [Доставка колбэков](/docs/v31/webhooks-callback).

***

См. также: [Статус рейса](/docs/v31/flight-status) · [Ограничения частоты запросов](/docs/rate-limits)