Обновите настройки справочного центра с помощью API Notiondesk

API Notiondesk позволяет изменять настройки вашего справочного центра непосредственно из кода: индексацию поисковыми системами, заголовок и описание страницы на каждом языке, оптимизацию с помощью ИИ, форму обратной связи и список изменений. Используйте его для применения одной и той же конфигурации к нескольким справочным центрам или для управления версиями настроек.

Языки и автоматический перевод описаны в отдельной статье: Управление языками и автоматическим переводом с помощью API Notiondesk . Цвета, шрифты и макеты описаны в разделе «Настройка фирменного стиля и тем справочного центра с помощью API Notiondesk» .

Как работают обновления настроек

Все маршруты на этой странице подчиняются одним и тем же правилам:

• Отправлять только то, что вы изменили. Поле, которое вы не указали, сохраняет свое текущее значение.

• Ответ — 204 No Content , без тела, даже если ничего не изменилось. Прочитайте новое состояние с помощью GET /sites/{site_id}, как описано в разделе «Чтение справочных центров с помощью API Notiondesk» .

• Отправляйте логические значения в формате JSON. Только значения true или false: значения 0 и "false" считываются как true.

• Неизвестные поля отклоняются с кодом ошибки 400 validation_error, и ничего не меняется.

• Повторные попытки безопасны при использовании Idempotency-Key. См. раздел «Обработка ошибок API Notiondesk, ограничений скорости и повторных попыток» .

Индексирование поисковыми системами, заголовки и описания страниц.

curl -i -X PATCH "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/settings/content" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16" \
  -H "Content-Type: application/json" \
  -d '{"seo_indexing_enabled": true, "items": [{"locale": "fr", "page_title": "Centre d aide Example", "page_description": "Toutes les réponses sur Example"}]}'

Каждый объект в items:

Объект изменяет только те поля, которые он содержит, а язык, который вы исключаете из items, сохраняет свое название и описание. items не может добавлять или удалять язык.

Ошибка в указании языка в пути к полю приводит, например, к слову items[fr].page_title.

seo_indexing_enabled: false Этот запрос требует от поисковых систем прекратить индексирование всего вашего справочного центра. См. раздел «Запрет поисковым системам сканировать и индексировать ваш справочный центр» .

Оптимизация с помощью ИИ

curl -i -X PATCH "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/settings/ai-optimization" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16" \
  -H "Content-Type: application/json" \
  -d '{"llms_txt_enabled": true, "markdown_export_enabled": true, "ai_contextual_menu_enabled": true}'

Ваш план должен включать оптимизацию с помощью ИИ. Узнайте, для чего нужна каждая функция, в разделе «Настройка оптимизации с помощью ИИ» в вашем справочном центре и в разделе «Введение в геооптимизацию/оптимизацию с помощью ИИ» .

Форма обратной связи

curl -i -X PATCH "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/settings/contact-form" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

• API включает или выключает форму, и ничего больше. Адреса, на которые поступают отправленные данные, задаются в панели управления. Сообщение с кодом destination_emails отвечает кодом 400 validation_error и ничего не меняет.

• Форма остается активной только при наличии сохраненного адреса. Включение ее для справочного центра без адреса приводит к ошибке 400 validation_error для destination_emails. Сначала укажите адрес в панели управления. Для отключения формы адрес не требуется.

• Ваш тарифный план должен включать расширенные возможности настройки, в том числе и отключение формы.

Список изменений

curl -i -X PATCH "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/settings/changelog" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true, "reactions_enabled": true, "changelog_categories": [{"category_id": "2984612035", "color": "blue_sky"}]}'

Каждый объект в changelog_categories имеет обязательный category_id, id одной из ваших коллекций и необязательный color длиной до 255 символов.

changelog_categories Заменяет весь набор. Если вы исключите какую-либо коллекцию, она перестанет быть коллекцией списка изменений, и все остальные коллекции будут удалены. Если вы хотите добавить только одну коллекцию, читайте с самого начала. Набор вмещает до 100 коллекций.[]changelog_categoriesGET /sites/{site_id}

Ваш тарифный план должен включать журнал изменений. Если подписка на рассылку по электронной почте включена, но ваш тарифный план больше не включает уведомления об изменениях по электронной почте, каждый запрос к этому маршруту будет возвращать ошибку 403 permission_denied до тех пор, пока не будет отправлено уведомление "email_subscriptions_enabled": false.

Подробнее об этом можно узнать в разделах «Настройка журналов изменений» в вашем справочном центре и «Как включить подписку на рассылку журналов изменений по электронной почте» .

Ошибки

См. раздел «Обработка ошибок API Notiondesk, ограничений скорости и повторных попыток» для получения информации о коде ошибки и других кодах.

Часто задаваемые вопросы

Что дальше?

• Настройте фирменный стиль и темы оформления справочного центра с помощью API Notiondesk

• Управление интеграцией справочного центра с помощью API Notiondesk

• Управление языками и автоматическим переводом с помощью API Notiondesk