docs/translations/ru-RU/content/rest/webhooks/index.md

title, intro, allowTitleToDifferFromFilename, versions, topics, miniTocMaxHeadingLevel, children, redirect_from, ms.openlocfilehash, ms.sourcegitcommit, ms.translationtype, ms.contentlocale, ms.lasthandoff, ms.locfileid

title	intro	allowTitleToDifferFromFilename	versions	topics	miniTocMaxHeadingLevel	children	redirect_from	ms.openlocfilehash	ms.sourcegitcommit	ms.translationtype	ms.contentlocale	ms.lasthandoff	ms.locfileid
Веб-перехватчики	API веб-перехватчиков позволяет создавать веб-перехватчики для репозиториев и управлять ими.	true	fpt ghes ghae ghec * * * *	API	3	/repo-config /repo-deliveries /repos	/rest/reference/webhooks	9216b892bbc19752266cea22d88bec655363ecaf	5f95274833	HT	ru-RU	09/11/2022	147882346

Веб-перехватчики репозитория позволяют получать полезные данные HTTP-запроса POST всякий раз, когда в репозитории происходят определенные события. {% data reusables.webhooks.webhooks-rest-api-links %}

Если вы хотите настроить один веб-перехватчик для получения событий изо всех репозиториев организации, ознакомьтесь с документацией по API для веб-перехватчиков организации.

Помимо REST API, {% data variables.product.prodname_dotcom %} также может служить центром PubSubHubbub для репозиториев.

Получение веб-перехватчиков

Для отправки полезных данных веб-перехватчика из {% data variables.product.product_name %} требуется доступ к серверу через Интернет. Также настоятельно рекомендуется использовать SSL для передачи зашифрованных полезных данных по протоколу HTTPS.

Заголовки веб-перехватчиков

{% data variables.product.product_name %} может отправлять несколько разных заголовков HTTP, которые позволяют различать типы событий и идентификаторы полезных данных. Дополнительные сведения см. разделе Заголовки веб-перехватчика.

PubSubHubbub

GitHub также может служить центром PubSubHubbub для всех репозиториев. PSHB — это простой протокол публикации и подписки, который позволяет серверам регистрироваться для получения обновлений при обновлении раздела. Обновления отправляются с HTTP-запросом POST на URL-адрес обратного вызова. URL-адреса разделов для отправок GitHub репозитория представлены в следующем формате:

https://github.com/{owner}/{repo}/events/{event}

Событие может быть любым доступным событием веб-перехватчика. Дополнительные сведения см. в разделе События веб-перехватчика и полезные данные.

Формат ответа

Формат по умолчанию — это то, что должны ожидать существующие перехватчики после получения: текста JSON, отправленного в качестве параметра payload в POST. Можно также указать получение необработанного текста JSON с заголовком Accept или расширением .json.

Accept: application/json
https://github.com/{owner}/{repo}/events/push.json

URL-адреса обратных вызовов

URL-адреса обратного вызова могут использовать протокол http://.

# Send updates to postbin.org
http://postbin.org/123

Подписка

Конечная точка PubSubHubbub GitHub: {% data variables.product.api_url_code %}/hub. Успешный запрос с curl выглядит следующим образом:

curl -u "user" -i \
  {% data variables.product.api_url_pre %}/hub \
  -F "hub.mode=subscribe" \
  -F "hub.topic=https://github.com/{owner}/{repo}/events/push" \
  -F "hub.callback=http://postbin.org/123"

Запросы PubSubHubbub можно отправлять несколько раз. Если перехватчик уже существует, он будет изменен в соответствии с запросом.

Параметры

Имя	Тип	Описание
hub.mode	string	Обязательно. subscribe или unsubscribe.
hub.topic	string	Обязательно. Универсальный код ресурса (URI) репозитория GitHub для подписки. Этот путь должен иметь следующий формат: /{owner}/{repo}/events/{event}.
hub.callback	string	Универсальный код ресурса (URI) для получения обновлений раздела.
hub.secret	string	Общий секретный ключ, который создает хэш-подпись исходящего содержимого текста. Вы можете убедиться, что отправка поступила из GitHub, сравнивая необработанный текст запроса с содержимым {% ifversion fpt or ghes or ghec %}заголовков X-Hub-Signature или X-Hub-Signature-256{% elsif ghae %}заголовка X-Hub-Signature-256{% endif %}. Дополнительные сведения см. в документации по PubSubHubbub.