API Dokumentation

Webhook erstellen

Events

Die folgenden Events können bei der Erstellung eines Webhooks als Auslöser angegeben werden. Die URL des Webhooks wird jedes mal aufgerufen, sobald das Ereignis eintritt.

Event-IDWird ausgeführt, sobald...
application.created... eine neue Bewerbung erstellt wurde.
application.deleted... eine Bewerbung gelöscht wurde.
application.hired... ein Bewerber eingestellt wurde.
application.rejected... ein Bewerber abgelehnt wurde.
job_offer.created... ein Stellenangebot erstellt wurde.
job_offer.deleted... ein Stellenangebot gelöscht wurde.
job_offer.published... ein Stellenangebot veröffentlicht wurde.
job_offer.archived... ein Stellenangebot archiviert wurde.

Fehler & Wiederholungen

Bei der Verwendung von Webhooks beachte die folgenden Richtlinien und Anforderungen:

  1. Zeitüberschreitung des Aufrufs: Ein Webhook-Aufruf gilt als fehlgeschlagen, wenn die Antwort von der angegebenen URL länger als 5 Sekunden dauert.
  2. Statuscode-Validierung: Ein erfolgreicher Aufruf muss einen HTTP-Statuscode im 2XX-Bereich zurückgeben. Andernfalls wird der Aufruf als fehlgeschlagen betrachtet.
  3. Wiederholungsversuche:
    • Bei einem fehlgeschlagenen Aufruf wird der Webhook automatisch noch zweimal kontaktiert, sodass insgesamt drei Aufrufe erfolgen.
    • Der zweite Aufruf erfolgt 10 Sekunden nach dem ersten Versuch.
    • Der dritte und letzte Aufruf erfolgt 100 Sekunden nach dem zweiten Versuch.
  4. SSL-Zertifikat: Die Ziel-URL des Webhooks muss über ein gültiges SSL-Zertifikat verfügen, um eine sichere Datenübertragung zu gewährleisten.

Diese Richtlinien sollen die Zuverlässigkeit und Sicherheit der Webhook-Integration in deiner Anwendung sicherstellen. Bitte stelle sicher, dass der Webhook-Endpunkt entsprechend konfiguriert ist, um eine optimale Funktionalität zu gewährleisten.

Language
Credentials
Header