GitHub Marketplace покупка полезных данных веб-перехватчика
Запросы веб-перехватчиков POST содержат специальные символы. Дополнительные сведения см. в разделе События и полезные данные веб-перехватчика. GitHub не выполняет повторную отправку в случае сбоя доставки. Убедитесь, что приложение может принимать все полезные данные веб-перехватчика, отправленные GitHub.
Отмена и понижение уровня вступают в силу в первый день следующего цикла выставления счетов. События понижения уровня и отмены отправляются, когда новый план вступает в силу в начале следующего цикла выставления счетов. События для новых покупок и обновлений начинаются немедленно. Используйте effective_date в полезных данных веб-перехватчика, чтобы определить, когда начнется изменение.
Примечание. Если вы обнаружили спам 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 | true, если account доступен в пробной бесплатной версии. |
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 долларов США в год, будет иметь значение "120 000 центов". |
price_model | string | Модель ценообразования для этого листинга. Может иметь значение FLAT_RATE, PER_UNIT или FREE. |
has_free_trial | boolean | true, если в этом листинге предлагается бесплатная пробная версия. |
unit_name | string | Имя единицы. Если модель ценообразования отличается от per-unit, будет иметь значение nil. |
bullet | array of strings | Имена маркеров, заданных в тарифном плане. |
Пример полезных данных веб-перехватчика для события purchased
В этом примере приведены полезные данные события purchased.
Пример полезных данных веб-перехватчика для события changed
Изменения в плане включают обновления и понижения уровня. В этом примере представлены полезные данные событий changed, pending_change и pending_change_cancelled. Действие определяет, какое из этих трех событий произошло.