웹후크 유형

웹후크 유형 정보

웹후크는 웹후크가 설치된 리포지토리, 조직, GitHub Marketplace 계정, GitHub Sponsors 계정 또는 GitHub App에서 사용 가능한 이벤트에만 액세스할 수 있습니다.

개별 사용자 계정 또는 개인 알림이나 멘션 등의 사용자 리소스와 관련된 이벤트에 대한 웹후크를 만들 수 없습니다.

웹후크를 만들고 관리하려면 웹후크가 생성되고 이벤트를 수신 대기하는 리소스에 대한 관리자 액세스 권한을 소유 또는 보유해야 합니다. 예를 들어 조직의 웹후크를 관리하려면 해당 조직에 대한 관리자 권한이 필요합니다.

일부 웹후크 이벤트는 웹후크 유형에 따라 다릅니다. 예를 들어 조직 웹후크는 리포지토리 웹후크가 구독할 수 없는 조직 수준에서만 발생하는 이벤트를 구독할 수 있습니다. 각 웹후크의 사용 가능성에 대한 자세한 내용은 웹후크 이벤트 및 페이로드을(를) 참조하세요.

자세한 내용은 웹후크 정보을(를) 참조하세요.

리포지토리 웹후크

리포지토리에 웹후크를 만들어 해당 리포지토리에서 발생하는 이벤트를 구독할 수 있습니다. 리포지토리에서 웹후크를 만들고 관리하려면 해당 리포지토리의 소유자이거나 리포지토리의 관리자 액세스 권한이 있어야 합니다. 필수 권한이 없는 리포지토리에서는 웹후크를 생성, 편집 또는 삭제할 수 없습니다.

단일 리포지토리에서 여러 개의 웹후크를 만들 수 있습니다. 그러나 개별 이벤트 유형을 각각 구독하는 최대 20개의 웹후크를 생성할 수 있습니다. 예를 들어 단일 리포지토리에서 각각 push 이벤트를 구독하는 최대 20개의 웹후크를 생성할 수 있습니다.

GitHub 웹 인터페이스나 REST API를 사용하여 리포지토리 웹후크를 관리할 수 있습니다. 자세한 내용은 웹후크 만들기, 웹후크 편집하기, 웹후크 사용 중지하기을(를) 참조하세요. REST API를 사용하여 리포지토리 웹후크를 관리하는 방법에 대한 자세한 내용은 리포지토리 웹후크에 대한 REST API 엔드포인트을(를) 참조하세요.

조직 웹후크

조직에서 웹후크를 만들어 해당 조직에서 발생하는 이벤트를 구독할 수 있습니다. 조직 웹후크는 조직이 소유한 모든 리포지토리에서 발생하는 이벤트를 구독할 수 있습니다. 또한 새 구성원이 조직에 추가되는 경우와 같이 특정 리포지토리 외부에 있는 조직 수준에서 발생하는 이벤트도 구독할 수 있습니다.

조직에서 웹후크를 만들고 관리하려면 해당 조직의 소유자여야 합니다.

단일 조직에서 여러 개의 웹후크를 만들 수 있습니다. 그러나 개별 이벤트 유형을 각각 구독하는 최대 20개의 웹후크를 생성할 수 있습니다. 예를 들어 단일 조직에서 각각 push 이벤트를 구독하는 최대 20개의 웹후크를 생성할 수 있습니다.

GitHub 웹 인터페이스나 REST API를 사용하여 조직 웹후크를 관리할 수 있습니다. 자세한 내용은 웹후크 만들기, 웹후크 편집하기, 웹후크 사용 중지하기을(를) 참조하세요. REST API를 사용하여 조직 웹후크를 관리하는 방법에 대한 자세한 내용은 조직 웹후크에 대한 REST API 엔드포인트을(를) 참조하세요.

GitHub Marketplace 웹후크

웹후크를 만들어 GitHub Marketplace에 게시한 앱과 관련된 이벤트를 구독할 수 있습니다. GitHub Marketplace에서 각 앱에 대해 하나의 웹후크만 만들 수 있습니다. 앱 소유자 또는 앱에 액세스할 수 있는 앱 관리자만 GitHub Marketplace 웹후크를 만들고 관리할 수 있습니다.

GitHub Marketplace 웹후크는 삭제할 수 없지만 웹후크 제공 수신을 중지하도록 비활성화할 수 있습니다.

GitHub 웹 인터페이스를 사용하여 GitHub Marketplace 웹후크를 관리할 수 있습니다. 자세한 내용은 웹후크 만들기, 웹후크 편집하기, 웹후크 사용 중지하기을(를) 참조하세요.

GitHub Sponsors 웹후크

웹후크를 만들어 GitHub Sponsors과(와) 관련된 이벤트를 구독할 수 있습니다. GitHub Sponsors 계정에서 최대 20개의 웹후크를 생성할 수 있습니다.

스폰서쉽 웹후크를 관리하려면 해당 스폰서 계정의 소유자이거나 관리자 액세스 권한이 있어야 합니다.

GitHub 웹 인터페이스를 사용하여 GitHub Sponsors 웹후크를 관리할 수 있습니다. 자세한 내용은 웹후크 만들기, 웹후크 편집하기, 웹후크 사용 중지하기을(를) 참조하세요.

GitHub App 웹후크

앱에 액세스 권한이 부여된 리포지토리 또는 조직에서 특정 이벤트가 발생할 때 웹후크를 수신하도록 GitHub App을 구성할 수 있습니다.

각 GitHub App에는 GitHub에서 자동으로 생성되는 단일 웹후크가 있습니다. 기본적으로 웹후크는 이벤트를 구독하지 않습니다. 웹후크가 구독할 이벤트를 구성할 수 있습니다. GitHub App 웹후크는 삭제할 수 없지만 웹후크 제공 수신을 중지하도록 비활성화할 수 있습니다.

GitHub 웹 인터페이스나 REST API를 사용하여 GitHub App 웹후크를 관리할 수 있습니다. 자세한 내용은 웹후크 만들기, 웹후크 편집하기, 웹후크 사용 중지하기을(를) 참조하세요. REST API를 사용하여 GitHub App 웹후크를 관리하는 방법에 대한 자세한 내용은 GitHub App 웹후크에 대한 REST API 엔드포인트을(를) 참조하세요.