Skip to main content

Enterprise Server 3.15 ist derzeit als Release Candidate verfügbar.

Arten von Webhooks

Sie können Webhooks erstellen, um Ereignisse zu abonnieren, die in einem bestimmten Repository, einer Organisation, GitHub Enterprise, einem oder der GitHub App auftreten.

Informationen zu Webhook-Typen

Ein Webhook kann nur auf Ereignisse zugreifen, die im Repository, der Organisation, GitHub Enterprise, dem oder der GitHub App, wo er installiert ist.

Sie können keine Webhooks für einzelne Benutzerkonten oder Ereignisse erstellen, die spezifisch für Benutzerressourcen sind, z. B. persönliche Benachrichtigungen oder Erwähnungen.

Zum Erstellen und Verwalten von Webhooks müssen Sie der Besitzer der Ressource sein oder über einen Administratorzugriff auf die Ressource verfügen, in der der Webhook erstellt wird und die auf Ereignisse überwacht wird. Um beispielsweise Webhooks in einer Organisation zu verwalten, benötigen Sie Administratorberechtigungen für diese Organisation.

Einige Webhook-Ereignisse sind für bestimmte Arten von Webhooks eindeutig. Beispielsweise kann ein Organisations-Webhook Ereignisse abonnieren, die nur auf Organisationsebene auftreten, die ein Repository-Webhook im Gegensatz dazu nicht abonnieren kann. Weitere Informationen über die spezifische Verfügbarkeit der einzelnen Webhooks finden Sie unter „Webhook-Ereignisse und -Nutzlasten“.

Weitere Informationen findest du unter Informationen zu Webhooks.

Repositorywebhooks

Sie können Webhooks in einem Repository erstellen, um Ereignisse zu abonnieren, die in diesem Repository auftreten. Sie müssen ein Repositorybesitzer sein oder Administratorzugriff im Repository haben, um Webhooks in einem Repository verwalten zu können. Sie können keine Webhooks in einem Repository erstellen, bearbeiten oder löschen, wenn Sie nicht über die erforderlichen Berechtigungen verfügen.

Sie können mehrere Webhooks in einem einzigen Repository erstellen. Sie können jedoch nur bis zu 250 Webhooks erstellen, die einzelne Ereignistypen abonnieren. In einem einzigen Repository könnten Sie zum Beispiel nur bis zu 250 verschiedene Webhooks erstellen, die jeweils das push-Ereignis abonnieren.

Sie können die Webschnittstelle GitHub oder die REST-API verwenden, um Repository-Webhook zu verwalten. Weitere Informationen findest du unter Erstellen von Webhooks, Bearbeiten von Webhooks und Deaktivieren von Webhooks. Weitere Informationen zur Verwendung der REST-API zur Verwaltung von Repository-Webhooks finden Sie unter „REST-API-Endpunkte für Repository-Webhooks“.

Organisationswebhooks

Sie können Webhooks in einer Organisation erstellen, um Ereignisse zu abonnieren, die in dieser Organisation auftreten. Organisations-Webhooks können Ereignisse abonnieren, die in allen Repositorys stattfinden, die sich im Besitz der Organisation befinden. Sie können auch Ereignisse abonnieren, die auf Organisationsebene außerhalb eines bestimmten Repositorys stattfinden, z. B. wenn ein neues Mitglied zur Organisation hinzugefügt wird.

Um in einer Organisation zu verwalten, müssen Sie Organisationsbesitzer sein.

Sie können mehrere Webhooks in einer einzigen Organisation erstellen. Sie können jedoch nur bis zu 250 Webhooks erstellen, die einzelne Ereignistypen abonnieren. In einer einzigen Organisation könnten Sie zum Beispiel nur bis zu 250 verschiedene Webhooks erstellen, die jeweils das push-Ereignis abonnieren.

Sie können die GitHub Webschnittstelle oder die REST API verwenden, um Organisations-Webhooks zu verwalten. Weitere Informationen findest du unter Erstellen von Webhooks, Bearbeiten von Webhooks und Deaktivieren von Webhooks. Weitere Informationen zur Verwendung der REST-API zum Verwalten von Organisations-Webhooks finden Sie unter „REST-API-Endpunkte für Organisationswebhooks“.

Globale Webhooks für GitHub Enterprise

Unternehmensbesitzer können globale Webhooks erstellen, um Ereignisse zu abonnieren, die in ihrem Unternehmen oder in Organisationen und Repositorys, die dem Unternehmen gehören, auftreten.

Sie können in einem einzigen Unternehmen mehrere Webhooks erstellen. Sie können jedoch nur bis zu 250 Webhooks erstellen, die einzelne Ereignistypen abonnieren. In einem einzigen Unternehmen könnten Sie zum Beispiel nur bis zu 250 verschiedene Webhooks erstellen, die jeweils das membership-Ereignis abonnieren.

Sie können die GitHub-Webschnittstelle verwenden, um globale Webhooks zu verwalten. Weitere Informationen findest du unter Erstellen von Webhooks, Bearbeiten von Webhooks und Deaktivieren von Webhooks. Du kannst auch die REST-API verwenden, um globale Webhooks zu verwalten. Eine vollständige Liste der Endpunkte findest du unter REST-API-Endpunkte für globale Webhooks.

GitHub App-Webhooks

Sie können eine GitHub App so konfigurieren, dass sie Webhooks empfängt, wenn bestimmte Ereignisse in einem Repository oder einer Organisation auftreten, auf die die App Zugriff gewährt hat.

Jede GitHub App verfügt über einen einzelnen Webhook, der automatisch von GitHub erstellt wird. Standardmäßig hat der Webhook keine Ereignisse abonniert. Sie können die Ereignisse konfigurieren, die der Webhook abonnieren soll. Ein GitHub App-Webhook kann nicht gelöscht werden, aber Sie können ihn deaktivieren, um keine Webhook-Zustellungen mehr zu erhalten.

Sie können die GitHub-Webschnittstelle oder die REST-API verwenden, um Webhook-Zustellungen für eine GitHub App zu verwalten. Weitere Informationen findest du unter Erstellen von Webhooks, Bearbeiten von Webhooks und Deaktivieren von Webhooks. Weitere Informationen zur Verwendung der REST-API zur Verwaltung von GitHub App-Webhooks finden Sie unter „REST-API-Endpunkte für GitHub App-Webhooks“.