ניהול שפות ותרגום אוטומטי בעזרת ממשק ה-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, תוך שמירה על השפות הנוכחיות:

מגבלות התוכנית

התוכנית שלך קובעת כמה שפות מרכז עזרה יכול לשרת. רשימה locales ארוכה יותר מזה תענה על 403 permission_denied.

כאשר מרכז העזרה שלך מאחסן שפה ש-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, מה שמפעיל את התרגום המחויב.

הפעלת תרגום אוטומטי מתחילה לתרגם את מרכז העזרה שלך. בפעם הראשונה, היא גם מפעילה חיוב תרגום עבור סביבת העבודה שלך. התוכנית שלך חייבת לכלול תרגום אוטומטי. למד כיצד זה עובד במדריך תחילת העבודה עם תרגום אוטומטי של בינה מלאכותית .

מה מחייב תרגום בזמן שהוא פועל

ראה סנכרון של Trigger Notion עם ממשק ה-API Notiondesk לקבלת מידע על אופן התרגום של סנכרונים.

שגיאות

ראה טיפול בשגיאות API Notiondesk, מגבלות קצב וניסיונות חוזרים עבור מעטפת השגיאה והקודים האחרים.

שאלות נפוצות

מה הלאה

• Trigger Notion מסתנכרן עם ממשק ה-API Notiondesk

• עדכון הגדרות מרכז העזרה באמצעות ממשק ה-API Notiondesk

• קרא מאמרים, אוספים ורשומות ביומן שינויים בעזרת ממשק ה-API Notiondesk