Webhooks & Benachrichtigungen
Webhooks liefern Push-Benachrichtigungen, wenn sich der Status eines überwachten Fluges ändert. Die Ereignisse stammen aus demselben Live-Flugstatus-Feed wie Flugstatus — Ihr Server erhält HTTP-POST-Callbacks, statt selbst regelmäßig abzufragen.
Voraussetzungen
x-api-key bei jeder Anfrage (Direktabonnement). Mehr erfahren →Pro, Ultra oder Mega — mit BASIC können keine Webhooks erstellt werden
Mehr erfahren →| 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.
| Endpoint | Seite | Einsatzzweck |
|---|---|---|
POST /webhooks | Abonnements | Callback-URL für einen Flug registrieren |
GET /webhooks | Abonnements | Abonnements Ihres API-Schlüssels auflisten |
PATCH /webhooks/{webhook_id} | Abonnements | Pausieren oder fortsetzen, ohne zu löschen |
DELETE /webhooks/{webhook_id} | Abonnements | Ein Abonnement dauerhaft entfernen |
GET /webhooks/events | Ereignistypen | Unterstützte Werte für event_types ermitteln |
| (eingehend) | Callback-Zustellung | 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-Polling in Intervallen unter einer Minute. Verwenden Sie Polling, wenn Sie Abfragen bei Bedarf ohne registrierte Callback-URL benötigen.
Fehlerantworten
Gemeinsame Plattformfehler: Fehlerbehandlung. Tarifbeschränkung:
403 — Tarif enthält keine Webhooks
{
"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 und Callback-Zustellung.
Siehe auch: Flugstatus · Rate Limits