Webhooks

Webhooks — это HTTP-уведомления, которые Pert отправляет на ваш сервер при наступлении событий в рабочем пространстве. Вместо того чтобы периодически опрашивать API, вы регистрируете один или несколько HTTPS-эндпоинтов и получаете push-уведомления о транзакциях, vault-аккаунтах и других объектах в реальном времени.

Зачем использовать webhooks

С webhooks вы можете:

получать уведомления о событиях в момент их наступления;
автоматизировать бизнес-процессы — нотификации, синхронизацию состояния, обновление UI;
хранить локальную копию данных без частых вызовов API.

Каждое событие отправляется отдельным HTTP POST-запросом. Тело подписывается через KMS на стороне Pert, и вы можете убедиться, что запрос действительно пришёл от нас и не был изменён в пути.

С чего начать

Регистрация webhook

Как создать, обновить и удалить webhook через API, какие роли нужны, ограничения и категории подписки.
Получение уведомлений

HTTP-заголовки, формат тела запроса и требования к ответу вашего сервера.
Верификация подписи

Алгоритм ECDSA-SECP256K1-SHA256, получение публичного ключа и примеры на Python, Node.js, Go.
Типы событий

Категории и event_type, на которые можно подписаться.
Повторные попытки и автоотключение

Расписание retry, окно повторов, автоматическое отключение после серии ошибок.
Replay

Как запросить повторную доставку пропущенных событий.
Лучшие практики

Идемпотентность, безопасность, производительность.

Кому доступны webhooks

Управление webhook доступно пользователям с одной из ролей:

Owner
Admin
Non-Signing Admin

Подробнее о том, какие роли могут просматривать и какие — управлять, см. на странице Регистрация webhook.

Жизненный цикл события

Если за 24 часа доставка так и не удалась, событие помечается как окончательно неуспешное. Если 50 событий подряд завершились неуспехом — webhook автоматически переводится в статус disabled (см. Автоотключение).