L'API Notiondesk consente di modificare le lingue supportate dal centro assistenza, scegliere la lingua predefinita e attivare o disattivare la traduzione automatica tramite IA. Utilizzatela per implementare una nuova lingua in più centri assistenza o per mantenere sincronizzate le impostazioni della lingua con la vostra configurazione.
| Metodo | Sentiero | Ambito di applicazione | Fa |
|---|---|---|---|
PATCH | /sites/{site_id}/settings/supported-languages | write | Imposta le lingue servite e la lingua predefinita |
PATCH | /sites/{site_id}/settings/auto-translate | write | Attiva o disattiva la traduzione automatica e ne imposta la lingua di origine. |
Entrambi i percorsi rispondono 204 No Content. Leggi il nuovo stato con GET /sites/{site_id}, come descritto in Consulta i tuoi centri di assistenza con l'API Notiondesk .
Imposta le lingue supportate dal tuo centro assistenza.
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"}'| Campo | Tipo | Note | Rileggi come |
|---|---|---|---|
locales | elenco di stringhe | Almeno una lingua per ogni lingua supportata dal centro assistenza. Ciascuna deve essere una delle available_locales del centro assistenza. | supported_locales |
default_locale | corda | La lingua a cui i lettori fanno ricorso. Deve essere nelle lingue risultanti e non può essere null | default_locale |
Un campo che si omette mantiene il suo valore corrente.
locales Sostituisce l'intero elenco. Una lingua che non viene inclusa viene rimossa dal centro assistenza, insieme alle relative impostazioni, come il titolo e la descrizione della pagina. Per aggiungere una lingua, leggi prima le istruzioni, poi invia l'elenco completo con la nuova lingua aggiunta.supported_localesLa stessa aggiunta in JavaScript, mantenendo i linguaggi attuali:
Piano limite
Il tuo piano definisce quante lingue può supportare un centro assistenza. Un elenco più lungo di questo risponde a 403 permission_denied.
Quando il tuo centro assistenza memorizza una lingua che il suo supported_locales non mostra, ogni richiesta a questo percorso risponde 403 permission_denied, indipendentemente da ciò che invii. Ciò accade quando:
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 }),
});- il centro assistenza supporta più lingue di quelle consentite dal piano, ad esempio dopo un downgrade;
- La lingua memorizzata è disabilitata;
- La lingua predefinita non ha impostazioni memorizzate e occupa uno dei posti disponibili nel piano.
Modifica le lingue del centro assistenza nella dashboard. L'API rifiuta la modifica per proteggere le lingue che non può mostrarti: una richiesta che modificasse solo la lingua predefinita le rimuoverebbe, insieme alle relative impostazioni. Vedi Supporto per più lingue nel tuo Centro assistenza .
Attiva o disattiva la traduzione automatica
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"}'| Campo | Tipo | Note |
|---|---|---|
auto_translate_enabled | booleano | Se le traduzioni mancanti vengono prodotte automaticamente |
auto_translate_source_locale | stringa o null | La traduzione automatica della lingua legge da. Deve essere uno dei supported_locales del centro assistenza. null lo cancella |
Invia i valori booleani JSON true o false. I valori 0 e "false" vengono letti come true, che attiva la traduzione a pagamento.
Attivando la traduzione automatica, il tuo centro assistenza inizierà a essere tradotto. La prima volta, verrà attivata anche la fatturazione della traduzione per il tuo spazio di lavoro. Il tuo piano deve includere la traduzione automatica. Scopri come funziona nella sezione "Introduzione alla traduzione automatica tramite IA" .
Quali sono le fatture da tradurre mentre è attivo
| Azione | Ciò che viene tradotto |
|---|---|
| Aggiungere una lingua | Il contenuto del centro assistenza, nella nuova lingua |
| Qualsiasi sincronizzazione, programmata o attivata | Il contenuto sincronizzato è cambiato nella lingua di origine e tutto ciò che non è ancora stato tradotto |
| Sincronizzazione di un articolo con i file caricati su Notion | Ogni lingua tradotta automaticamente di quell'articolo, anche con testo invariato |
Consulta la sezione "Trigger Notion si sincronizza con l'API Notiondesk" per capire come vengono tradotte le sincronizzazioni.
Errori
| Stato | Quando | code |
|---|---|---|
| 400 | locales è vuoto o contiene una lingua non disponibile, default_locale è null o non è presente nelle lingue risultanti, auto_translate_source_locale non è una delle lingue del centro assistenza oppure il corpo contiene un campo sconosciuto | validation_error |
| 403 | La chiave non ha l'ambito write | insufficient_scope |
| 403 | Troppe lingue per il tuo piano, una lingua memorizzata è nascosta (vedi Limiti del piano ), il tuo piano non include la traduzione automatica oppure il creatore della chiave non può modificare questo centro assistenza | permission_denied |
| 404 | Il centro assistenza non è presente nel tuo spazio di lavoro | not_found |
Consultare la sezione "Errori API, limiti di frequenza e tentativi" dell'handle Notiondesk per informazioni sull'intestazione dell'errore e sugli altri codici.
Domande frequenti
Come faccio ad aggiungere una lingua senza rimuovere le altre?
Leggi il file supported_locales del centro assistenza, aggiungi la nuova lingua e invia l'intero elenco come locales. Il percorso sostituisce l'elenco con quello che invii.
Quali codici lingua posso utilizzare?
Quelli presenti nel centro assistenza available_locales, restituiti da GET /sites/{site_id}.
Posso tradurre un singolo articolo tramite API?
No. La traduzione automatica viene eseguita sull'intero centro assistenza quando è attiva e ogni sincronizzazione traduce le modifiche apportate. L'API permette di attivarla o disattivarla e di impostarne la lingua di origine.
La rimozione di una lingua comporta l'eliminazione degli articoli ad essa correlati in Notion?
No. L'API non modifica mai i contenuti di Notion. La rimozione di una lingua impedisce al centro assistenza di fornirla e rimuove le impostazioni del centro assistenza relative a quella lingua.