Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Informationen zu Webhooks

In this article

Hier lernst du die Grundlagen der Funktionsweise von Webhooks kennen, damit du Integrationen erstellen und einrichten kannst.

Mit Webhooks kannst du Integrationen erstellen oder einrichten, wie z. B. GitHub Apps oder OAuth Apps, die bestimmte Ereignisse auf GitHub.com abonnieren. Wenn ein solches Ereignis ausgelöst wird, senden wir HTTP POST-Nutzdaten an die für den Webhook konfigurierte URL. Webhooks können verwendet werden, um einen externen Issue-Tracker zu aktualisieren, CI-Builds auszulösen, eine Sicherungsspiegelung zu aktualisieren oder sogar eine Bereitstellung auf deinem Produktionsserver durchzuführen. Nur deine Fantasie setzt die Grenzen.

Webhooks können auf einer Organisation, einem bestimmten Repository oder einer GitHub App installiert werden. Nach der Installation wird der Webhook jedes Mal gesendet, wenn ein oder mehrere abonnierte Ereignisse auftreten.

Du kannst bis zu 20 Webhooks für jedes Ereignis auf jedem Installationsziel (bestimmte Organisation oder bestimmtes Repository) erstellen.

Events

Beim Konfigurieren eines Webhooks kannst du die UI oder API verwenden, um auszuwählen, welche Ereignisse dir Nutzlasten senden. Nur das Abonnieren der spezifischen Ereignisse, die du für die Behandlung planst, beschränkt die Anzahl der HTTP-Anforderungen auf deinen Server. Du kannst auch alle aktuellen und zukünftigen Ereignisse abonnieren. Standardmäßig werden Webhooks nur für das Push-Ereignis abonniert. Du kannst die Liste der abonnierten Ereignisse jederzeit ändern.

Jedes Ereignis entspricht einer bestimmten Gruppe von Aktionen, die bei deiner Organisation und bzw. oder dem Repository auftreten können. Wenn du beispielsweise das issues-Ereignis abonnierst, erhältst du jedes Mal detaillierte Nutzdaten, wenn ein Issue geöffnet, geschlossen, gekennzeichnet wird usw.

Eine vollständige Liste der verfügbaren Webhook-Ereignisse und ihrer Nutzdaten findest du unter Webhook-Ereignisse und Nutzdaten.

Ping-Ereignis

Wenn du einen neuen Webhook erstellst, senden wir dir ein einfaches ping-Ereignis, um dir mitzuteilen, dass du den Webhook richtig eingerichtet hast. Dieses Ereignis wird nicht gespeichert und ist daher nicht über den Ereignis-API-Endpunkt abrufbar.

Weitere Informationen zu ping-Ereigniswebhook-Nutzdaten findest du im ping-Ereignis.