Уведомления о событиях

Webhook сообщает вашей системе о событиях площадки — объявлениях, откликах, модерации, сообщениях, заказах — без опроса.

Как подключить

1. В разделе «API» в блоке «Webhooks» нажмите «Добавить webhook».
2. Введите «Адрес» своей системы и отметьте «События».
3. Сохраните webhook.
4. Нажмите «Секрет подписи» в строке адреса и сохраните секрет в своей системе.

Из своей системы адреса заводятся, читаются и снимаются ключом с разрешением «Управление уведомлениями» — операции /rest/v1/identity/seller/webhooks, секрет — /rest/v1/identity/seller/webhooks/{id}/secret.

Как принимать

• Тело — JSON: type — тип события, timestamp — момент, data — данные; схема data каждого события — в «Справочник API».
• Подпись — по Standard Webhooks: заголовки webhook-id, webhook-timestamp, webhook-signature; проверяйте её библиотекой стандарта до применения содержимого.
• Ответ — 2xx сразу, обработка — у себя асинхронно; неудачную доставку площадка повторяет.

Журнал доставок

1. Нажмите «Журнал доставок» в строке адреса: события новыми первыми с исходом и следующей попыткой.
2. «Повторить доставку» у события отправляет его ещё раз.
3. «Тестовая отправка» шлёт подписанный пример выбранного события — проверка приёма до первого настоящего.

Событие с удалённым по сроку хранения содержимым не повторяется.