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

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

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

Оба варианта позволяют начать платный перевод. Добавление языка при включенном автоматическом переводе переводит ваш контент на этот язык, а включение автоматического перевода запускает перевод вашего справочного центра. В обоих случаях плата взимается за символы перевода. Для начала ознакомьтесь с информацией о ценах и оплате автоматического перевода с помощью ИИ .

Укажите языки, на которых работает ваш справочный центр.

curl -i -X PATCH "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/settings/supported-languages" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16" \
  -H "Content-Type: application/json" \
  -d '{"locales": ["en", "fr", "de"], "default_locale": "en"}'

Поле, которое вы не указали, сохраняет своё текущее значение.

locales Заменяет весь список. Язык, который вы не упомянули, будет удален из справочного центра вместе с его настройками, такими как заголовок страницы и описание. Чтобы добавить язык, сначала прочтите список, а затем отправьте полный список с добавленным новым языком.supported_locales

Аналогичное дополнение в JavaScript, с сохранением существующих языков:

Плановые ограничения

Ваш тарифный план определяет, сколько языков может обслуживать центр поддержки. Список, превышающий это количество, отвечает на 403 вопроса.

Когда ваш справочный центр хранит язык, который не отображается в его supported_locales, каждый запрос к этому маршруту получает ответ 403 permission_denied, независимо от того, что вы отправляете. Это происходит, когда:

const siteId = "c74781f6-1aea-4e17-ab23-bbb8b4d174b6";
const headers = {
  Authorization: `Bearer ${process.env.NOTIONDESK_API_KEY}`,
  "nd-version": "2026-10-16",
  "Content-Type": "application/json",
};

const site = await (await fetch(`https://api.notiondesk.so/sites/${siteId}`, { headers })).json();
const locales = [...new Set([...site.supported_locales, "de"])];

await fetch(`https://api.notiondesk.so/sites/${siteId}/settings/supported-languages`, {
  method: "PATCH",
  headers,
  body: JSON.stringify({ locales }),
});

• В справочном центре доступно больше языков, чем позволяет тарифный план, например, после понижения уровня подписки;

• Сохраненный язык отключен;

• Язык по умолчанию не имеет сохраненных настроек и занимает одно из мест, указанных в тарифном плане.

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

Включить или выключить автоматический перевод

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

Отправьте логические значения JSON true или false. Значения 0 и "false" считываются как true, что включает платный перевод.

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

Что касается перевода счетов, пока он включен?

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

Ошибки

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

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

Что дальше?

• Trigger Notion синхронизируется с API Notiondesk

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

• Читайте статьи, подборки и записи об изменениях с помощью API Notiondesk