Подключить API экспорта блога
Подключите API, чтобы передавать опубликованные материалы вашей организации в CMS или автоматизацию.
API позволяет читать опубликованные материалы вашей организации, для которых включена выгрузка. API блога и RSS не выдают черновики и архивные посты. Ключ блога и персональный MCP-токен базы знаний — разные учётные данные.
- Откройте «Интеграции блога» → «Ключи API».
- Задайте название подключения, создайте ключ и сразу сохраните его: он показывается один раз.
- Передавайте ключ на серверной стороне принимающего приложения в заголовке
Authorization: Bearer …. - Запросите список материалов по пути
GET /api/public-api/v1/blog/postsна домене установки Noteall. - Получите выбранный материал:
GET /api/public-api/v1/blog/posts/{id_or_slug}. - Передайте поля текста в свою CMS, затем откройте результат и проверьте оформление, изображения и ссылки.
В ответе отдельного материала доступны, в частности, body_md, body_html, изображения и jsonld. Для списка предусмотрены updated_since, tag, content_type, cursor и limit. Продолжение выдачи возвращается в next_cursor.
Проверка: запросите тестовый материал, для которого разрешён экспорт, с ключом вашей организации. HTTP 401 означает проблему с ключом. HTTP 404 для отдельного материала означает, что по указанному идентификатору нет экспорта, доступного этому ключу.
Если в вашем интерфейсе недоступно управление выдачей, обратитесь к команде Noteall.
Храните ключ на сервере принимающей системы, а не в публичном JavaScript сайта. Отозвать ключ можно в списке ключей интеграций.