Mit der Notiondesk-API können Sie die Sprachen Ihres Hilfezentrums ändern, die Standardsprache festlegen und die automatische KI-Übersetzung aktivieren oder deaktivieren. Nutzen Sie sie, um eine neue Sprache in mehreren Hilfezentren einzuführen oder um die Spracheinstellungen mit Ihrer Konfiguration zu synchronisieren.
| Verfahren | Weg | Umfang | Tut |
|---|---|---|---|
PATCH | /sites/{site_id}/settings/supported-languages | write | Legt die verfügbaren Sprachen und die Standardsprache fest. |
PATCH | /sites/{site_id}/settings/auto-translate | write | Schaltet die automatische Übersetzung ein oder aus und legt die Ausgangssprache fest. |
Beide Routen antworten mit 204 No Content. Lesen Sie den neuen Status mit GET /sites/{site_id}, wie in „Lesen Sie Ihre Hilfezentren mit der Notiondesk API“ beschrieben.
Legen Sie die Sprachen fest, die Ihr Hilfecenter unterstützt.
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"}'| Feld | Typ | Anmerkungen | Lesen Sie zurück als |
|---|---|---|---|
locales | Liste von Zeichenketten | Für jede Sprache, die das Hilfezentrum bedient, muss mindestens eine davon verfügbar sein. Jede dieser Sprachen muss eine der available_locales des Hilfezentrums sein. | supported_locales |
default_locale | Zeichenkette | Die Sprache, auf die die Leser zurückgreifen. Muss in den resultierenden Sprachen enthalten sein und darf nicht null sein. | default_locale |
Ein Feld, das Sie weglassen, behält seinen aktuellen Wert.
locales Ersetzt die gesamte Liste. Eine fehlende Sprache wird aus dem Hilfezentrum entfernt, zusammen mit den zugehörigen Einstellungen wie Seitentitel und Beschreibung. Um eine Sprache hinzuzufügen, lesen Sie bitte zuerst die Liste und senden Sie sie anschließend mit der neuen Sprache.supported_localesDie gleiche Ergänzung in JavaScript, wobei die aktuellen Sprachen beibehalten werden:
Planbeschränkungen
Ihr Tarif legt fest, in wie vielen Sprachen ein Hilfecenter Unterstützung bietet. Eine Liste, die länger ist, führt zu einem 403-Fehler.
Wenn Ihr Hilfecenter eine Sprache speichert, die in der URL nicht angezeigt wird, antwortet jede Anfrage an diese Route mit dem Fehlercode 403 (PRESERVED_27), unabhängig von der gesendeten E-Mail-Adresse. Dies geschieht, wenn:
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 }),
});- Das Hilfecenter bietet mehr Sprachen an, als der Tarif zulässt, beispielsweise nach einem Downgrade.
- Eine gespeicherte Sprache ist deaktiviert;
- Die Standardsprache hat keine gespeicherten Einstellungen und belegt einen der Plätze im Tarifplan.
Ändern Sie die Sprachen des Hilfecenters im Dashboard. Die API lehnt die Änderung ab, um die Sprachen zu schützen, die sie Ihnen nicht anzeigen kann: Eine Anfrage, die nur die Standardsprache ändert, würde diese Sprachen und ihre Einstellungen andernfalls entfernen. Weitere Informationen finden Sie unter „Mehrere Sprachen im Hilfecenter unterstützen“ .
Automatische Übersetzung ein- oder ausschalten
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"}'| Feld | Typ | Anmerkungen |
|---|---|---|
auto_translate_enabled | boolescher Wert | Ob fehlende Übersetzungen automatisch erstellt werden |
auto_translate_source_locale | Zeichenkette oder Null | Die automatische Übersetzung liest aus der Sprache, die im Hilfecenter unter supported_locales aufgeführt ist. null löscht dies. |
Senden Sie die JSON-Booleschen Werte true oder false. Die Werte 0 und "false" werden als true interpretiert, wodurch die kostenpflichtige Übersetzung aktiviert wird.
Wenn Sie die automatische Übersetzung aktivieren, wird Ihr Hilfecenter übersetzt. Beim ersten Mal wird dadurch auch die Übersetzungsgebühr für Ihren Arbeitsbereich aktiviert. Ihr Tarif muss die automatische Übersetzung beinhalten. Weitere Informationen finden Sie unter „Erste Schritte mit KI-gestützter automatischer Übersetzung“ .
Welche Rechnungsübersetzungen, während es läuft
| Aktion | Was wird übersetzt? |
|---|---|
| Hinzufügen einer Sprache | Die Inhalte des Hilfezentrums in die neue Sprache |
| Jede Synchronisierung, ob geplant oder ausgelöst | Der Inhalt, der sich in der Quellsprache geändert hat, und alles, was noch nicht übersetzt wurde. |
| Eine Artikelsynchronisierung für einen Artikel mit in Notion hochgeladenen Dateien | Jede automatisch übersetzte Sprache dieses Artikels, selbst bei unverändertem Text |
Siehe Trigger Notion syncs with the Notiondesk API für how syncs translate.
Fehler
| Status | Wann | code |
|---|---|---|
| 400 | locales ist leer oder enthält eine nicht verfügbare Sprache, default_locale ist null oder nicht in den resultierenden Sprachen enthalten, auto_translate_source_locale ist keine der Sprachen des Hilfezentrums oder der Textkörper enthält ein unbekanntes Feld | validation_error |
| 403 | Dem Schlüssel fehlt der Gültigkeitsbereich write. | insufficient_scope |
| 403 | Zu viele Sprachen für Ihren Tarif, eine gespeicherte Sprache ist ausgeblendet (siehe Tarifbeschränkungen ), Ihr Tarif beinhaltet keine automatische Übersetzung oder der Ersteller des Schlüssels kann dieses Hilfezentrum nicht ändern | permission_denied |
| 404 | Das Hilfecenter ist in Ihrem Arbeitsbereich nicht vorhanden. | not_found |
Siehe Handle Notiondesk API errors, rate limits, and retries für den Fehlerumschlag und die anderen Codes.
Häufig gestellte Fragen
Wie kann ich eine Sprache hinzufügen, ohne die anderen zu entfernen?
Lesen Sie den Hilfeartikel supported_locales, fügen Sie die neue Sprache hinzu und senden Sie die gesamte Liste als locales. Die Route ersetzt die Liste durch die von Ihnen gesendeten Daten.
Welche Sprachcodes kann ich verwenden?
Diejenigen im Hilfezentrum unter available_locales, die von GET /sites/{site_id} zurückgegeben werden.
Kann ich mit der API einen einzelnen Artikel übersetzen?
Nein. Die automatische Übersetzung läuft im gesamten Hilfecenter, solange sie aktiviert ist, und jede Synchronisierung übersetzt die vorgenommenen Änderungen. Die API aktiviert oder deaktiviert die Übersetzung und legt die Ausgangssprache fest.
Werden durch das Entfernen einer Sprache deren Artikel in Notion gelöscht?
Nein. Die API ändert niemals Ihre Notion-Inhalte. Wenn Sie eine Sprache entfernen, wird diese nicht mehr vom Hilfecenter bereitgestellt und die Einstellungen des Hilfecenters für diese Sprache werden gelöscht.