Zarządzaj językami i automatycznym tłumaczeniem za pomocą interfejsu API Notiondesk

Interfejs API Notiondesk umożliwia zmianę języków obsługiwanych przez centrum pomocy, wybór języka domyślnego oraz włączanie i wyłączanie automatycznego tłumaczenia AI. Można go używać do wdrażania nowego języka w kilku centrach pomocy lub do synchronizowania ustawień językowych z własną konfiguracją.

Obie trasy odpowiadają na 204 No Content. Odczytaj nowy stan za pomocą GET /sites/{site_id}, zgodnie z opisem w sekcji „Odczytuj swoje centra pomocy za pomocą interfejsu API Notiondesk” .

Obie ścieżki umożliwiają rozpoczęcie tłumaczenia płatnego. Dodanie języka, gdy włączone jest automatyczne tłumaczenie, powoduje przetłumaczenie treści na ten język, a włączenie automatycznego tłumaczenia rozpoczyna tłumaczenie Centrum pomocy. W obu przypadkach opłata jest naliczana według liczby znaków w tłumaczeniu. Najpierw zapoznaj się z cennikiem i rozliczeniami automatycznego tłumaczenia AI .

Ustaw języki, w których działa Twoje centrum pomocy

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"}'

Pominięte pole zachowuje swoją obecną wartość.

locales zastępuje całą listę. Pominięty język zostanie usunięty z centrum pomocy wraz z ustawieniami dla tego języka, takimi jak tytuł strony i opis. Aby dodać język, najpierw przeczytaj, a następnie wyślij pełną listę z dodanym nowym językiem.supported_locales

Ten sam dodatek w JavaScript, przy zachowaniu obecnych języków:

Limity planu

Twój plan określa liczbę języków, w których może działać centrum pomocy. Lista locales dłuższa niż ta odpowiada na kod 403 permission_denied.

Gdy Twoje centrum pomocy przechowuje język, którego supported_locales nie wyświetla, każde żądanie do tej trasy odpowiada 403 permission_denied, niezależnie od tego, co wyślesz. Dzieje się tak, gdy:

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 }),
});

• centrum pomocy obsługuje więcej języków, niż pozwala plan, na przykład po obniżeniu wersji;

• zapisany język jest wyłączony;

• domyślny język nie ma żadnych zapisanych ustawień i zajmuje jedno z miejsc planu.

Zmień języki w Centrum pomocy w panelu. Interfejs API odmawia wprowadzenia zmiany, aby chronić języki, których nie może wyświetlić: żądanie zmiany tylko języka domyślnego spowodowałoby usunięcie ich wraz z ustawieniami. Zobacz sekcję Obsługa wielu języków w Centrum pomocy .

Włącz lub wyłącz automatyczne tłumaczenie

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"}'

Wyślij wartości logiczne JSON true lub false. Wartości 0 i "false" są odczytywane jako true, co powoduje włączenie tłumaczenia rozliczanego.

Włączenie automatycznego tłumaczenia uruchamia tłumaczenie Centrum pomocy. Po pierwszym włączeniu zostanie również włączone rozliczanie tłumaczeń dla Twojego obszaru roboczego. Twój plan musi obejmować automatyczne tłumaczenie. Dowiedz się, jak to działa w artykule „Rozpoczęcie korzystania z automatycznego tłumaczenia AI” .

Jakie rachunki są tłumaczone, gdy są włączone

Zobacz, jak przebiega synchronizacja w Trigger Notion z API Notiondesk .

Błędy

Zobacz temat Obsługa błędów API Notiondesk, limitów szybkości i ponownych prób, aby zapoznać się z obwiednią błędu i innymi kodami.

Często zadawane pytania

Co dalej?

• Trigger Notion synchronizuje się z API Notiondesk

• Zaktualizuj ustawienia centrum pomocy za pomocą interfejsu API Notiondesk

• Czytaj artykuły, kolekcje i wpisy w dzienniku zmian za pomocą interfejsu API Notiondesk