Webhooks

Webhooks ermöglichen es externen Diensten, Daten an Blitz Rocket zu senden, wenn Ereignisse in Ihrer Anwendung auftreten. Verwenden Sie Webhooks, um automatisch Wettbewerbseinträge zu erstellen, wenn sich Benutzer auf Ihrer Plattform anmelden, oder um Punkte zu vergeben, wenn Einkäufe getätigt werden.

Wie Webhooks funktionieren

Sie konfigurieren eine Webhook-URL in Ihrem externen System (z. B. Shopify, Stripe oder Ihrem benutzerdefinierten Backend)
Wenn ein Ereignis eintritt (Anmeldung, Kauf), sendet Ihr System eine HTTP-POST-Anfrage an den Blitz Rocket Webhook-Endpunkt
Blitz Rocket verarbeitet das Ereignis, erstellt oder aktualisiert Einträge und vergibt Punkte

Verfügbare Webhook-Endpunkte

Webhook	Endpoint	Zweck
Signup	`POST /api/webhooks/signup/:contestId`	Einträge aus externen Anmeldungen erstellen
Purchase	`POST /api/webhooks/purchase/:contestId`	Einkäufe aus externen Shops verfolgen

Webhook-Sicherheit

Jede Webhook-Verbindung verfügt über einen geheimen Schlüssel, den Sie in Ihren Teameinstellungen konfigurieren können. Beim Senden von Webhook-Anfragen fügen Sie das Geheimnis im Anfragetext oder als Header hinzu, um die Authentizität zu überprüfen.

Unterstützte Integrationen

Blitz Rocket unterstützt Webhooks von:

Shopify — Automatische Bestell- und Kunden-Webhooks
Stripe — Zahlungs- und Abonnement-Webhooks
Custom — Jedes System, das HTTP-POST-Anfragen senden kann

Webhook vs API

Funktion	Webhooks	REST API
Richtung	Extern → Blitz Rocket	Ihr Code → Blitz Rocket
Authentifizierung	Webhook-Geheimnis	API-Schlüssel
Anwendungsfall	Ereignisgesteuerte Automatisierung	Abrufbare Operationen
Echtzeit	Ja (Push)	Nein (Pull)

Verwenden Sie Webhooks, wenn Sie eine automatisierte, ereignisgesteuerte Erstellung von Einträgen und Verfolgung von Käufen wünschen. Verwenden Sie die REST API, wenn Sie eine feinere Steuerung der Operationen benötigen.