Met de Notiondesk API kunt u de talen wijzigen die uw helpcentrum ondersteunt, de standaardtaal kiezen en automatische AI-vertaling in- of uitschakelen. Gebruik de API om een nieuwe taal in meerdere helpcentra uit te rollen of om de taalinstellingen te synchroniseren met uw eigen configuratie.
| Methode | Pad | Domein | Doet |
|---|---|---|---|
PATCH | /sites/{site_id}/settings/supported-languages | write | Hiermee worden de ondersteunde talen en de standaardtaal ingesteld. |
PATCH | /sites/{site_id}/settings/auto-translate | write | Hiermee kunt u automatische vertaling in- of uitschakelen en de brontaal instellen. |
Beide routes geven als antwoord 204 No Content. Lees de nieuwe status met GET /sites/{site_id}, zoals beschreven in Lees uw helpcentra met de Notiondesk API .
Stel de talen in die uw helpcentrum ondersteunt.
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"}'| Veld | Type | Notities | Lees terug als |
|---|---|---|---|
locales | lijst van strings | Voor elke taal die het helpcentrum ondersteunt, ten minste één. Elk van deze talen moet een van de available_locales talen van het helpcentrum zijn. | supported_locales |
default_locale | snaar | De taal waarnaar lezers terugvallen. Moet in de resulterende talen zijn en mag niet null zijn. | default_locale |
Een veld dat je weglaat, behoudt zijn huidige waarde.
locales Vervangt de hele lijst. Een taal die u weglaat, wordt uit het helpcentrum verwijderd, samen met de bijbehorende instellingen, zoals de paginatitel en -beschrijving. Om een taal toe te voegen, leest u eerst de instructies en stuurt u vervolgens de volledige lijst met de nieuwe taal.supported_localesDezelfde toevoeging in JavaScript, met behoud van de huidige talen:
Planlimieten
Uw abonnement bepaalt hoeveel talen een helpcentrum kan ondersteunen. Een lijst die langer is dan dat beantwoordt 403 vragen.
Wanneer uw helpcentrum een taal opslaat die niet wordt weergegeven in de supported_locales-lijst, beantwoordt elk verzoek aan deze route met 403 permission_denied, ongeacht wat u verzendt. Dit gebeurt wanneer:
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 }),
});- Het helpcentrum biedt meer talen aan dan het abonnement toestaat, bijvoorbeeld na een downgrade;
- Een opgeslagen taal is uitgeschakeld;
- De standaardtaal heeft geen opgeslagen instellingen en neemt een van de plaatsen van het abonnement in.
Wijzig de talen van dat helpcentrum in het dashboard. De API weigert de wijziging om de talen te beschermen die niet kunnen worden weergegeven: een verzoek dat alleen de standaardtaal wijzigt, zou deze anders inclusief de instellingen verwijderen. Zie Meerdere talen ondersteunen in uw helpcentrum .
Automatische vertaling in- of uitschakelen
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"}'| Veld | Type | Notities |
|---|---|---|
auto_translate_enabled | booleaans | Of ontbrekende vertalingen automatisch worden gegenereerd |
auto_translate_source_locale | tekenreeks of null | De taal die de automatische vertaling gebruikt, moet een van de talen zijn die in het helpcentrum zijn gereserveerd (supported_locales). null wist deze taal. |
Verzend de JSON-booleans true of false. De waarden 0 en "false" worden gelezen als true, waardoor de factuurvertaling wordt ingeschakeld.
Door automatische vertaling in te schakelen, wordt uw helpcentrum vertaald. De eerste keer worden er ook vertaalkosten voor uw werkruimte in rekening gebracht. Uw abonnement moet automatische vertaling omvatten. Lees meer over hoe het werkt in Aan de slag met AI-geautomatiseerde vertaling .
Welke wetsvoorstellen worden er vertaald terwijl ze actief zijn?
| Actie | Wat wordt er vertaald? |
|---|---|
| Een taal toevoegen | De inhoud van het helpcentrum, in de nieuwe taal. |
| Elke synchronisatie, gepland of geactiveerd | De inhoud die door de synchronisatie is gewijzigd in de brontaal, en alles wat nog niet is vertaald. |
| Een artikel synchroniseert de bestanden die naar Notion zijn geüpload. | Elke automatisch vertaalde taal van dat artikel, zelfs met ongewijzigde tekst. |
Zie Trigger Notion synchroniseert met de Notiondesk API voor meer informatie over hoe synchronisaties tot stand komen.
Fouten
| Status | Wanneer | code |
|---|---|---|
| 400 | locales is leeg of bevat een niet-beschikbare taal, default_locale is null of staat niet in de resulterende talen, auto_translate_source_locale is niet een van de talen van het helpcentrum, of de inhoud bevat een onbekend veld. | validation_error |
| 403 | De sleutel mist het bereik write | insufficient_scope |
| 403 | Te veel talen voor uw abonnement, een opgeslagen taal is verborgen (zie Abonnementslimieten ), uw abonnement bevat geen automatische vertaling of de maker van de sleutel kan dit helpcentrum niet wijzigen. | permission_denied |
| 404 | Het helpcentrum bestaat niet in uw werkruimte. | not_found |
Zie 'API-fouten, snelheidslimieten en herhaalpogingen afhandelen' voor de foutomvang en de andere codes.
Veelgestelde vragen
Hoe kan ik een taal toevoegen zonder de andere talen te verwijderen?
Lees de help-informatie van supported_locales, voeg de nieuwe taal toe en verstuur de volledige lijst als locales. De route vervangt de lijst door wat je verstuurt.
Welke taalcodes kan ik gebruiken?
De exemplaren in het helpcentrum, available_locales, geretourneerd door GET /sites/{site_id}.
Kan ik met de API één enkel artikel vertalen?
Nee. Automatische vertaling wordt op het hele helpcentrum uitgevoerd zolang deze functie is ingeschakeld, en elke synchronisatie vertaalt de wijzigingen. De API schakelt de functie in of uit en stelt de brontaal in.
Worden de artikelen in een taal die voor een bepaalde taal bedoeld zijn, ook verwijderd in Notion?
Nee. De API wijzigt nooit de inhoud van je Notion-account. Het verwijderen van een taal zorgt ervoor dat het helpcentrum die taal niet meer aanbiedt en verwijdert de instellingen van het helpcentrum voor die taal.