# Webhooks & Benachrichtigungen

Push-Benachrichtigungen bei Flugstatusänderungen – Webhook-Abonnements nach Flugnummer erstellen, auflisten, aktivieren, deaktivieren und löschen.



Webhooks liefern Push-Benachrichtigungen, wenn sich der Status eines überwachten Fluges ändert. Die Ereignisse stammen aus demselben Live-Flugstatus-Feed wie [Flugstatus](/docs/v31/flight-status) — Ihr Server erhält HTTP-`POST`-Callbacks, statt selbst regelmäßig abzufragen.

<DocRequirements>
  <DocRequirementAuth />

  <DocRequirement label="Tarif" href="/docs/rate-limits#plans">
    Pro, Ultra oder Mega — mit BASIC können keine Webhooks erstellt werden
  </DocRequirement>
</DocRequirements>

| Tarif | Max. aktive Webhooks     |
| ----- | ------------------------ |
| BASIC | 0 (Erstellung abgelehnt) |
| PRO   | 1                        |
| ULTRA | 3                        |
| MEGA  | 10                       |

Der Status wird alle **5 Minuten** abgefragt. Abonnements werden nach **10 aufeinanderfolgenden fehlgeschlagenen Zustellungen** automatisch deaktiviert. Alle Details zu den Tarifen: [Rate Limits](/docs/rate-limits).

| Endpoint                        | Seite                                                                  | Einsatzzweck                                   |
| ------------------------------- | ---------------------------------------------------------------------- | ---------------------------------------------- |
| `POST /webhooks`                | [Abonnements](/docs/v31/webhooks-subscriptions#create-webhook)         | Callback-URL für einen Flug registrieren       |
| `GET /webhooks`                 | [Abonnements](/docs/v31/webhooks-subscriptions#list-webhooks)          | Abonnements Ihres API-Schlüssels auflisten     |
| `PATCH /webhooks/{webhook_id}`  | [Abonnements](/docs/v31/webhooks-subscriptions#enable-disable-webhook) | Pausieren oder fortsetzen, ohne zu löschen     |
| `DELETE /webhooks/{webhook_id}` | [Abonnements](/docs/v31/webhooks-subscriptions#delete-webhook)         | Ein Abonnement dauerhaft entfernen             |
| `GET /webhooks/events`          | [Ereignistypen](/docs/v31/webhooks-subscriptions#event-types)          | Unterstützte Werte für `event_types` ermitteln |
| *(eingehend)*                   | [Callback-Zustellung](/docs/v31/webhooks-callback)                     | HTTP-`POST`-Body, den Ihr Server empfängt      |

**Webhooks oder Polling.** Für Benachrichtigungen über Gate-Wechsel reichen Webhooks mit einem Abfrageintervall von 5 Minuten in der Regel aus und sind weitaus günstiger als ein [Flugstatus](/docs/v31/flight-status)-Polling in Intervallen unter einer Minute. Verwenden Sie Polling, wenn Sie Abfragen bei Bedarf ohne registrierte Callback-URL benötigen.

## Fehlerantworten [#error-responses]

Gemeinsame Plattformfehler: [Fehlerbehandlung](/docs/errors). Tarifbeschränkung:

### 403 — Tarif enthält keine Webhooks [#403--plan-does-not-include-webhooks]

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

Endpoint-spezifische Fehler (404 bei fehlender Eigentümerschaft, Callback-Zustellung) finden Sie unter [Abonnements](/docs/v31/webhooks-subscriptions) und [Callback-Zustellung](/docs/v31/webhooks-callback).

***

Siehe auch: [Flugstatus](/docs/v31/flight-status) · [Rate Limits](/docs/rate-limits)