Skip to main content

플랜 변경 내용을 알리도록 웹후크 구성

GitHub Marketplace 목록 초안을 만든 후 고객 계정 플랜에 변경이 발생할 때 알림을 제공하는 웹후크를 구성할 수 있습니다. 웹후크를 구성한 후 앱에서 marketplace_purchase이벤트 유형을 처리할 수 있습니다.

참고: 이 문서는 GitHub Marketplace의 앱 게시에만 적용됩니다. GitHub Actions의 GitHub Actions 배포에 대한 자세한 내용은 "GitHub Marketplace에서 작업 게시"을(를) 참조하세요.

GitHub Marketplace 이벤트 웹후크는 애플리케이션의 GitHub Marketplace 목록 페이지에서만 설정할 수 있습니다. 애플리케이션의 개발자 설정 페이지에서 다른 모든 이벤트를 구성할 수 있습니다. GitHub Marketplace 목록을 만들지 않은 경우 "앱 목록 초안 작성"을(를) 참조하여 방법을 알아보세요.

웹후크 만들기

GitHub Marketplace 목록에서 웹후크를 만들려면 GitHub Marketplace 목록 페이지의 왼쪽 사이드바에서 웹후크를 클릭합니다. 웹후크를 구성하는 데 필요한 다음 웹후크 구성 옵션이 표시됩니다.

페이로드 URL

페이로드 URL은 웹후크 POST 요청을 수신하는 서버의 URL입니다.

내용 유형

다양한 콘텐츠 형식을 사용하여 웹후크를 전달할 수 있습니다.

  • application/json 콘텐츠 형식은 JSON 페이로드를 POST 요청의 본문으로 직접 전달합니다.
  • application/x-www-form-urlencoded 콘텐츠 형식은 JSON 페이로드를 payload라는 양식 매개 변수로 전송합니다.

필요에 가장 적합한 설정을 선택합니다. GitHub에서는 application/json 콘텐츠 형식을 사용하는 것이 좋습니다.

암호

웹후크 비밀을 설정하면 페이로드 URL로 전송된 POST 요청이 GitHub Enterprise Cloud에서 전송되었는지 확인할 수 있습니다. 비밀을 설정한 경우 웹후크 POST 요청의 X-Hub-SignatureX-Hub-Signature-256 헤더를 수신합니다. 서명 헤더가 있는 비밀을 사용하여 웹후크 페이로드를 보호하는 방법에 대한 자세한 내용은 "웹후크 제공 유효성 검사하기" 항목을 참조하세요.

활성화

기본적으로 웹후크는 “활성”으로 제공됩니다. 개발 중에 “활성”을 선택 취소하여 웹후크 페이로드의 제공을 사용하지 않도록 선택할 수 있습니다. 웹후크 제공을 사용하지 않도록 설정한 경우 검토를 위해 앱을 제출하기 전 “활성”을 선택해야 합니다.

웹후크 제공 보기

GitHub Marketplace 웹후크를 구성하면 애플리케이션의 GitHub Marketplace 목록에 대한 웹후크 페이지에서 POST 요청 페이로드를 검사할 수 있습니다. GitHub는 제공 시도가 실패하면 다시 전송하지 않습니다. 앱이 GitHub에서 보낸 모든 웹후크 페이로드를 받을 수 있는지 확인합니다.

GitHub Marketplace 목록에 대한 최근 웹후크 제공 스크린샷.