Informationen zu Webhook-Typen
Ein Webhook kann nur auf Ereignisse zugreifen, die in dem Repository, der Organisation, GitHub Enterprise, oder GitHub App verfügbar sind, 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 einzigartig für bestimmte Webhooks. 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 findest du unter Webhook-Ereignisse und Webhook-Nutzlasten.
Weitere Informationen finden Sie 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 jeden einzelnen Ereignistyp abonnieren. In einem einzigen Repository können Sie z. B. nur bis zu 250 verschiedene Webhooks erstellen, die jeweils das Ereignis push abonnieren.
Sie können die GitHub Webschnittstelle oder die REST-API verwenden, um Repository-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 Repositorywebhooks findest du 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 Webhooks in einer Organisation zu erstellen und 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 jeden einzelnen Ereignistyp abonnieren. In einer einzelnen Organisation können Sie beispielsweise höchstens 250 verschiedene Webhooks erstellen, die jeweils das Ereignis push abonnieren.
Sie können die GitHub Webschnittstelle oder die REST-API zum Verwalten von Organisationswebhooks verwenden. 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 Organisationswebhooks findest du 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 jeden einzelnen Ereignistyp abonnieren. In einem Unternehmen können Sie beispielsweise nur bis zu 250 verschiedene Webhooks erstellen, die jeweils das Ereignis membership 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 ein GitHub App so konfigurieren, dass Webhooks gesendet werden, wenn bestimmte Ereignisse in einem Repository oder einer Organisation auftreten, auf die die App Zugriff erhalten hat.
Jeder GitHub App verfügt über einen Webhook, der automatisch von GitHub erstellt wird. Standardmäßig ist der Webhook nicht für Ereignisse abonniert. Sie können die Ereignisse konfigurieren, die der Webhook abonnieren soll. Ein GitHub App Webhook kann nicht gelöscht, aber deaktiviert werden, um keine Webhook-Zustellungen mehr zu erhalten.
Sie können die GitHub Webschnittstelle oder die REST-API verwenden, um einen GitHub App 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 zum Verwalten GitHub App von Webhooks finden Sie unter REST-API-Endpunkte für GitHub App Webhooks.