Блог

Страница для тех, кто подключает к Gigonom блог на своём сайте. Блог работает в одном из двух режимов: Gigonom сам отправляет статью на ваш сайт или готовит её, а размещаете вы. Как создать канал в Gigonom и что общего у всех каналов, рассказано на странице «Подключение каналов».

Ручной режим

Если поле «Webhook автопубликации» на странице канала пустое, блог работает вручную. ИИ-помощник готовит статью, а в срок публикации Gigonom присылает уведомление «Пора разместить». Вы размещаете статью на сайте и отмечаете публикацию вышедшей.

Автопубликация через webhook

Webhook — адрес на вашем сайте, на который Gigonom отправляет каждую статью запросом. Сам адрес и его обработку делает разработчик сайта.

1. Получите у разработчика адрес webhook и вставьте его в поле «Webhook автопубликации».
2. Нажмите «Сохранить».
3. Откройте настройки канала ещё раз и в блоке «Подпись запросов» нажмите «Включить».
4. Скопируйте показанный секрет и передайте его разработчику, чтобы сайт проверял подпись.

Если статус в блоке подписи «подпись включена», блог подключён. Проверьте его тестовой статьёй, как описано на странице «Подключение каналов».

Для разработчика сайта

Gigonom отправляет POST на адрес webhook с заголовком Content-Type: application/json. Тело запроса:

{
  "topic": { "name": "<название темы>", "slug": "<слаг темы>", "brief": "<описание темы>" },
  "content_markdown": "<текст статьи в markdown>",
  "published_at": "<дата и время в ISO 8601>"
}

Картинки и ссылки лежат внутри markdown, ссылки уже размечены UTM-метками.

Если подпись включена, в заголовке x-content-signature приходит HMAC-SHA256 сырого тела запроса в шестнадцатеричном виде, без префикса. Ключом служит секрет из настроек канала, взятый как строка.

Любой ответ с кодом 2xx считается успехом. Если в ответе JSON с полем url, Gigonom сохранит его как адрес вышедшей статьи. Ответ с другим кодом помечает публикацию ошибкой, повторной отправки нет.