Text of docs.github.com › de › enterprise-server@3.19 › webhooks › webhook-events-and-payloads as Styx crawled it on Oct 14, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

Webhook-Ereignisse und Webhook-Nutzlasten - GitHub Enterprise Server 3.19 Docs

Skip to main content Skip to content Randleiste reduzieren Randleiste erweitern Webhook-Ereignisse und Webhook-Nutzlasten Hier erfährst du, wann jedes Webhookereignis auftritt und was die Nutzlast enthält. In diesem Artikel Informationen zu Webhook-Ereignissen und -Nutzdaten Du kannst Webhooks erstellen, die die auf dieser Seite aufgeführten Ereignisse abonnieren. Um die Anzahl von HTTP-Anforderungen an deinen Server zu begrenzen, solltest du nur die spezifischen Ereignisse abonnieren, die du behandeln möchtest.

Weitere Informationen finden Sie unter Erstellen von Webhooks . Jedes Webhook-Ereignis auf dieser Seite enthält eine Beschreibung der Webhook-Eigenschaften für dieses Ereignis. Wenn das Ereignis über mehrfache Aktionen verfügt, sind die den einzelnen Aktionen entsprechenden Eigenschaften enthalten. Jedes Ereignis ist nur für bestimmte Webhook-Typen verfügbar. Beispielsweise kann ein team -Ereignis von einem Organisations-Webhook abonniert werden, nicht aber von einem Repository-Webhook.

In der Beschreibung jedes Webhook-Ereignisses wird die Verfügbarkeit für dieses Ereignis angegeben. Weitere Informationen finden Sie unter Arten von Webhooks . Die sender -Eigenschaft. Die meisten Webhook-Nutzlasten enthalten eine sender Eigenschaft, die den Benutzer identifiziert, der das Ereignis ausgelöst hat. Manchmal GitHub kann ein bestimmter Benutzer nicht aufgelöst werden, z. B. wenn ein Ereignis von einem internen Prozess und nicht von einer Person stammt oder wenn die auslösende Aktion keinen zugehörigen Benutzer hat.

Bei einigen Ereignissen, wie check_run und check_suite , schließt dies Aktionen ohne Git-Push oder authentifizierten API-Akteur ein. In diesen Fällen wird sender mit dem ghost Benutzer ausgefüllt, einem Platzhalterkonto, dessen login``ghost ist und dessen id keinem echten, aktuellen Benutzer zugeordnet ist. Gehen Sie nicht davon aus, dass sender immer die Person identifiziert, die ein Ereignis verursacht hat, und berücksichtigen Sie den ghost Benutzer in jeder Sicherheits- oder Geschäftslogik, die darauf basiert.

Nutzdatenobergrenze Nutzdaten sind auf 25 MB begrenzt. Wenn ein Ereignis eine größere Nutzdatenmenge generiert, übermittelt GitHub keine Nutzdaten für dieses Webhook-Ereignis. Dies kann beispielsweise bei einem create -Ereignis geschehen, wenn viele Branches oder Tags gleichzeitig verschoben werden. Es wird empfohlen, die Nutzlastgröße zu überwachen, um die Übermittlung sicherzustellen. Lieferheader HTTP-POST-Nutzlasten, die an den konfigurierten URL-Endpunkt deines Webhook übermittelt werden, enthalten mehrere spezielle Header: X-GitHub-Hook-ID : Der eindeutige Bezeichner des Webhooks.

X-GitHub-Event : Der Name des Ereignisses, das die Zustellung ausgelöst hat. X-GitHub-Delivery : Eine GUID (Globally Unique Identifier), um das Ereignis zu identifizieren. X-GitHub-Enterprise-Version : Die Version der GitHub Enterprise Server Instanz, die die HTTP POST-Nutzlast gesendet hat. X-GitHub-Enterprise-Host : Der Hostname der GitHub Enterprise Server Instanz, die die HTTP POST-Nutzlast gesendet hat. X-Hub-Signature : Dieser Header wird gesendet, wenn der Webhook mit secret konfiguriert ist.

Dies ist der HMAC-Hex-Digest des Anforderungstexts und wird mithilfe der SHA-1-Hashfunktion und des secret als HMAC key generiert. X-Hub-Signature wird aus Gründen der Kompatibilität mit bestehenden Integrationen bereitgestellt. Wir empfehlen, stattdessen die sicherere X-Hub-Signature-256 zu verwenden. X-Hub-Signature-256 : Dieser Header wird gesendet, wenn der Webhook mit secret konfiguriert ist. Dies ist der HMAC-Hex-Digest des Anforderungstexts und wird mithilfe der SHA-256-Hashfunktion und des secret als HMAC key generiert.

Weitere Informationen finden Sie unter Validierung der Webhook-Lieferungen . User-Agent : Diese Kopfzeile hat immer das Präfix GitHub-Hookshot/ . X-GitHub-Hook-Installation-Target-Type : Der Typ der Ressource, in der der Webhook erstellt wurde. X-GitHub-Hook-Installation-Target-ID : Der eindeutige Bezeichner der Ressource, in der der Webhook erstellt wurde. Informationen dazu, wie jeder Header in einer Webhook-Nutzlast aussehen kann, finden Sie unter Beispiel für eine Webhook-Zustellung .

Beispiel für die Webhook-Zustellung Sie können auswählen, ob Nutzdaten im JSON-Format ( application/json ) oder als URL-codierte Daten ( x-www-form-urlencoded ) zugestellt werden sollen. Nachfolgend sehen Sie ein Beispiel für eine Webhook POST-Anforderung im JSON-Format. > POST /payload HTTP/1.1 > X-GitHub-Delivery: 72d3162e-cc78-11e3-81ab-4c9367dc0958 > X-GitHub-Enterprise-Version: 2.15.0 > X-GitHub-Enterprise-Host: example.com > X-Hub-Signature: sha1=7d38cdd689735b008b3c702edd92eea23791c5f6 > X-Hub-Signature-256: sha256=d57c68ca6f92289e6987922ff26938930f6e66a2d161ef06abdf1859230aa23c > User-Agent: GitHub-Hookshot/044aadd > Content-Type: application/json > Content-Length: 6615 > X-GitHub-Event: issues > X-GitHub-Hook-ID: 292430182 > X-GitHub-Hook-Installation-Target-ID: 79929171 > X-GitHub-Hook-Installation-Target-Type: repository > { > "action" : "opened" , > "issue" : { > "url" : "http(s)://HOSTNAME/api/v3/repos/octocat/Hello-World/issues/1347" , > "number" : 1347, > ... > }, > "repository" : { > "id" : 1296269, > "full_name" : "octocat/Hello-World" , > "owner" : { > "login" : "octocat" , > "id" : 1, > ... > }, > ... > }, > "sender" : { > "login" : "octocat" , > "id" : 1, > ... > } > } branch_protection_configuration This event occurs when there is a change to branch protection configurations for a repository.

For more information, see " About protected branches ." For information about using the APIs to manage branch protection rules, see " Branch protection rule " in the GraphQL documentation or " Branch protection " in the REST API documentation. To subscribe to this event, a GitHub App must have at least read-level access for the "Administration" repository permission. Verfügbarkeit für branch_protection_configuration Repositories Organisationen GitHub Apps Webhook-Payload-Objekt für branch_protection_configuration All branch protections were disabled for a repository.

Webhook-Anforderungstextparameter Name, Typ, BESCHREIBUNG action string Erforderlich Wert : disabled enterprise object An enterprise on GitHub. Webhook payloads contain the enterprise property when the webhook is configured on an enterprise account or an organization that's part of an enterprise account. For more information, see " About enterprise accounts ." installation object The GitHub App installation. Webhook payloads contain the installation property when the event is configured for and sent to a GitHub App.

For more information, see " Using webhooks with GitHub Apps ." organization object A GitHub organization. Webhook payloads contain the organization property when the webhook is configured for an organization, or when the event occurs from activity in a repository owned by an organization. repository object Erforderlich The repository on GitHub where the event occurred. Webhook payloads contain the repository property when the event occurs from activity in a repository. sender object Erforderlich A GitHub user. branch_protection_rule This event occurs when there is activity relating to branch protection rules.

For more information, see " About protected branches ." For information about the APIs to manage branch protection rules, see the GraphQL documentation or " Branch protection " in the REST API documentation. To subscribe to this event, a GitHub App must have at least read-level access for the "Administration" repository permission. Verfügbarkeit für branch_protection_rule Repositories Organisationen GitHub Apps Webhook-Payload-Objekt für branch_protection_rule A branch protection rule was created.

Webhook-Anforderungstextparameter Name, Typ, BESCHREIBUNG action string Erforderlich Wert : created enterprise object An enterprise on GitHub. Webhook payloads contain the enterprise property when the webhook is co

The rest of this page is on the live site.