Помощь / Внешние сервисы

Настроить вебхуки и RSS для блога

Настройте передачу событий через вебхуки и импорт опубликованных материалов через RSS в свою систему публикаций.

Настроить вебхук

Вебхук сообщает вашей системе об изменении материала. Полный текст получите отдельным запросом API.

  1. Подготовьте HTTPS-адрес приёма событий в своей системе.

  2. В «Интеграциях блога» добавьте его в блоке «Вебхуки».

  3. Сохраните секрет вебхука в принимающей системе.

  4. Настройте проверку заголовка X-Noteall-Signature: значение sha256= и HMAC-SHA256 от исходных байтов тела запроса с секретом вебхука.

  5. Настройте обработку событий. Вебхуки приходят только по опубликованным постам:

    • post.published — при публикации поста с включённой выгрузкой или при включении выгрузки;
    • post.updated — при правке опубликованного поста;
    • post.unpublished — при снятии с публикации или отключении выгрузки.

    В сообщении передаются post_id, slug, occurred_at и api_url.

  6. Для публикации или обновления получите текст через API. Для снятия с публикации настройте соответствующее действие в своей CMS.

  7. Проверьте «Последние доставки» и фактическое состояние поста в принимающей системе.

Доставка может повторяться. Используйте X-Noteall-Delivery для защиты от повторной обработки, а post_id — для обновления существующей статьи без создания дубля. При успешном приёме ваша система должна возвращать ответ 2xx. Если вебхук завершится с ошибкой, изменение материала в Noteall сохранится.

Настроить RSS

В том же разделе включите «RSS-фид», выберите, нужен ли полный текст, скопируйте выданный URL и добавьте его в средство импорта. RSS-фид содержит только опубликованные посты и предназначен для внешнего чтения материалов. Перед передачей ссылки проверьте содержимое фида.

Проверка: убедитесь, что одна тестовая статья корректно переносится и обновляется. Отключение вебхука или RSS прекращает дальнейшую выдачу соответствующим способом. Уже созданные копии в CMS останутся.

Связанные статьи

Статья помогла?