Ein Webhook ist eine URL auf deinem Server, die wir aufrufen, wenn etwas passiert, damit dein Code nicht ständig nachfragen muss.
Einrichten
- Wähl unter Entwickler Webhooks, dann Endpunkt hinzufügen.
- Gib eine HTTPS-URL ein und wähl die gewünschten Ereignisse, zum Beispiel
question.completed. - Kopier das Signatur-Secret. Es wird nur einmal angezeigt.
Ereignisse
Fragen reserviert, abgeschlossen, unvollständig, abgebrochen oder abgelehnt; Credits gekauft, knapp oder bald ablaufend; Reklamationen entschieden; und eine Verbindung nahe ihrem Limit.
Die Signatur prüfen
Jede Zustellung hat einen Header x-50heads-signature mit einem Zeitstempel und einem HMAC-SHA256 des Bodys, erstellt mit deinem Secret. Prüf ihn, bevor du dem Inhalt vertraust. Die Webhook-Dokumentation (auf Englisch) hat Code zum Kopieren.
Wiederholungen
Antworte innerhalb von zehn Sekunden mit einem 2xx-Status. Sonst versuchen wir es mit zunehmendem Abstand erneut, achtmal über 24 Stunden. Das Protokoll Zustellungen zeigt jeden Versuch, und du kannst jede Zustellung erneut auslösen.
Zustellungen können gelegentlich doppelt oder in falscher Reihenfolge ankommen. Nutz die Ereignis-ID, um Wiederholungen zu ignorieren.