참고: 이 문서는 GitHub Marketplace의 GitHub Apps 배포에만 적용됩니다. GitHub Actions의 GitHub Actions 배포에 대한 자세한 내용은 "GitHub Marketplace에서 작업 게시"를 참조하세요.
웹후크 및 GitHub Marketplace 정보
웹후크 POST 요청에는 특별한 헤더가 있습니다. 자세한 내용은 "웹후크 이벤트 및 페이로드"을 참조하세요. GitHub는 제공 시도가 실패하면 다시 전송하지 않습니다. 앱이 GitHub에서 보낸 모든 웹후크 페이로드를 받을 수 있는지 확인합니다. GitHub Marketplace 웹후크를 만들고 사용하지 않도록 설정하는 방법에 대한 자세한 내용은 "웹후크 만들기" 및 "웹후크 사용 중지하기"을(를) 참조하세요.
취소 및 다운그레이드는 다음 청구 기간의 첫 날에 적용됩니다. 다운그레이드 및 취소에 대한 이벤트는 새 플랜이 다음 청구 기간의 시작 부분에 적용될 때 전송됩니다. 새 구매 및 업그레이드에 대한 이벤트는 즉시 시작됩니다. 웹후크 페이로드에서 effective_date를 사용하여 변경이 시작되는 시점을 확인합니다.
참고: 스팸 GitHub Marketplace 구매 또는 기타 악의적인 동작을 알아챈 경우 사용자에 대한 자세한 정보를 사용하여 신고하기 양식을 작성하세요.
GitHub Marketplace에 대한 구매 웹후크 페이로드 정보
각 marketplace_purchase 웹후크 페이로드에는 다음 정보가 있습니다.
| 키 | 형식 | 설명 |
|---|---|---|
action | string | 웹후크를 생성하기 위해 수행된 작업. purchased, cancelled, pending_change, pending_change_cancelled 또는 changed일 수 있습니다. 자세한 내용은 아래 웹후크 페이로드 예제를 참조하세요. 참고:pending_change 및 pending_change_cancelled 페이로드는 페이로드 예제changed에 표시된 것과 동일한 키를 포함하고 있습니다. |
effective_date | string | action이 적용되는 날짜 |
sender | object | 웹후크를 트리거한 action을 수행한 사람 |
marketplace_purchase | object | GitHub Marketplace 구매 정보 |
marketplace_purchase 개체에는 다음 키가 있습니다.
| 키 | 형식 | 설명 |
|---|---|---|
account | object | 구독과 연결된 organization 및 user 계정. 조직 계정에는 조직의 관리 메일 주소인 organization_billing_email이(가) 포함됩니다. 개인 계정의 메일 주소를 찾으려면 인증된 사용자 가져오기 엔드포인트를 사용할 수 있습니다. |
billing_cycle | string | yearly 또는 monthly일 수 있습니다. account 소유자가 무료 GitHub 플랜을 사용 중이고 무료 GitHub Marketplace 플랜을 구입하면 billing_cycle은 nil입니다. |
unit_count | integer | 구매한 단위 수 |
on_free_trial | boolean | account가 평가판을 사용 중이면 true |
free_trial_ends_on | string | 평가판이 만료될 날짜 |
next_billing_date | string | 다음 청구 기간이 시작되는 날짜. account 소유자가 무료 GitHub.com 플랜을 사용 중이고 무료 GitHub Marketplace 플랜을 구입하면 next_billing_date는 nil입니다. |
plan | object | user 또는 organization이 구매한 플랜 |
plan 개체에는 다음 키가 있습니다.
| 키 | 형식 | 설명 |
|---|---|---|
id | integer | 플랜의 고유 식별자 |
name | string | 플랜의 이름 |
description | string | 플랜에 대한 설명 |
monthly_price_in_cents | integer | 플랜의 월별 비용(단위: 미국 통화 센트). 예를 들어 매월 10달러의 비용이 드는 목록은 1000센트가 됩니다. |
yearly_price_in_cents | integer | 플랜의 연간 비용(단위: 미국 통화 센트). 예를 들어 매월 100달러의 비용이 드는 목록은 120000센트가 됩니다. |
price_model | string | 이 목록의 가격 책정 모델. FLAT_RATE, PER_UNIT 또는 FREE 중 하나일 수 있습니다. |
has_free_trial | boolean | 목록이 평가판을 제공하는 경우 true |
unit_name | string | 단위의 이름. 가격 책정 모델이 per-unit이 아닌 경우에는 nil입니다. |
bullet | array of strings | 가격 책정 플랜에 설정된 글머리 기호의 이름 |