Пользовательские webhook'и
Стройте что угодно поверх Analyse: каждое событие блога может доставляться на ваш HTTP endpoint в виде JSON payload с подписью HMAC-SHA256, чтобы вы могли проверить источник.
Каждое событие блога
Подпишитесь на blog_post.published, updated, unpublished и deleted — каждое доставляется как HTTP POST с JSON-телом.
Запросы с подписью HMAC
При заданном секрете подписи каждый запрос включает заголовок X-Analyse-Signature — HMAC-SHA256 сырого тела — чтобы ваш endpoint мог проверить подлинность.
Несколько endpoint'ов
Добавляйте столько webhook endpoint'ов, сколько нужно — у каждого свой URL, секрет и подписки на события.
Как это работает
Укажите Analyse ваш endpoint, выберите события и проверьте подпись.
- 1
Добавьте endpoint
В Analyse откройте Интеграции → Webhook и введите URL для приёма событий, а также опциональный секрет подписи.
- 2
Выберите события
Выберите, какие события блога доставляются — публикация, обновление, снятие с публикации или удаление.
- 3
Проверьте подпись
Вычислите HMAC-SHA256 сырого тела запроса с вашим секретом и сравните с заголовком X-Analyse-Signature.
- 4
Отправьте тестовое событие
Доставьте пример payload, чтобы убедиться, что endpoint обрабатывает его корректно.
Часто задаваемые вопросы
Как выглядит payload?
HTTP POST с Content-Type: application/json, содержащий имя события, метку времени и данные поста: id, title, slug, excerpt, тело в markdown, URL обложки, дату публикации, URL и категории. События unpublished и deleted содержат null в теле.
Какие события доступны?
blog_post.published, blog_post.updated, blog_post.unpublished и blog_post.deleted. вы выбираете, какие из них получает каждый endpoint.
Как проверить, что запрос пришёл от Analyse?
Задайте секрет подписи; каждая доставка тогда включает X-Analyse-Signature: sha256=<hex> — HMAC-SHA256 сырого тела с вашим секретом. Отклоняйте всё, что не совпадает.
Стройте на событиях Analyse
Подписанные JSON webhook'и для каждого события блога — подключите что угодно.