דילוג לתוכן

Plugins

תוספים לסביבת העבודה ולאפליקציות שלכם.

פתיחת Plugins
נבדק מול לוח הבקרה ב-18 בנובמבר 2026

לתוספים יש שש שיטות ציבוריות. הן מפרטות תוספים ומנהלות את התוספים שרצים עם פרויקט בשרתים של Xuda, הפס השני של דף התוספים. כל אחת פועלת עבור החשבון שמפתח ה-API שלו משתמשים בו.

הוספת תוסף לשרת של סביבת העבודה, בנייה שלו, הרצה שלו והגדרת המפתחות שלו נעשות בלוח הבקרה. כיום אין להן שיטה ציבורית, ו-install_plugin דוחה תוסף שרץ רק על שרת של סביבת עבודה.

שולחים בקשה לשיטה עם המפתח שלכם. זו מפרטת את הווידג'טים של זירת המסחר:

curl -s https://xuda.ai/cpi/get_plugins \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","category":"widget","limit":20}'
const res = await fetch('https://xuda.ai/cpi/get_plugins', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', category: 'widget', limit: 20 }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/get_plugins',
    json={'api_key': 'YOUR_API_KEY', 'category': 'widget', 'limit': 20},
)

לתשובה תקינה יש code 1. לתשובה שנדחתה יש code שלילי, והיא אומרת מדוע ב-data.

למצוא תוספים

  • get_plugins מפרטת את התוספים בזירת המסחר. היא מקבלת plugin_id אופציונלי (המזהה המלא, עם הקידומת @xuda.io/ שלו) או id (בלעדיה), category (סוג תוסף), limit (9999 אם לא צוין) ו-skip לדפדוף. התוספים הפרטיים שלכם מופיעים ברשימה עבורכם ועבור אף אחד אחר.
  • get_plugins_categories מפרטת את סוגי התוספים. היא לא מקבלת שדות.
  • get_app_plugins מפרטת את התוספים שמותקנים באפליקציה. היא מקבלת app_id ו-plugin_type_filter אופציונלי.

להתקין ולהסיר תוסף של פרויקט

ההתקנה דורשת קודם הסכמה לתנאים של התוסף, כמו בלוח הבקרה.

  1. קוראים ל-get_install_consent עם item_kind שנקבע ל-plugin ועם plugin_name. היא מחזירה את התנאים ו-content_hash.
  2. קוראים ל-install_plugin עם app_id, plugin_name ו-consent, אובייקט עם accepted, עם ה-content_hash שקיבלתם ועם locale. בלי הסכמה תקפה ההתקנה נדחית ושום דבר לא נכתב.

install_plugin מקבלת גם consent_source (באיזה מסך ההסכמה התקבלה, לרשומת הביקורת בלבד), validate_free (כשהוא true, תוסף עם מחיר נדחה) ו-version (לעדכון, הגרסה שהוצעה לכם: גרסה שאינה האחרונה נדחית).

uninstall_plugin מקבלת app_id ו-plugin_name ומסירה את התוסף מהאפליקציה. היא לא שואלת שוב.

להעלות תוסף פרטי

upload_plugin שומרת חבילת תוסף. היא קוראת מהגוף את data.plugin_name ו-data.plugin_type (אחד מ-dbs, widget, graphics, library, platform, framework, util, ui), עם data.package_source (npm, ברירת המחדל, או xuda_hosted עם data.package_url) ו-data.visibility. קובעים את data.visibility ל-private כדי להשאיר אותו מחוץ לזירת המסחר.

העלאה פרטית דורשת את חברות Agency או את התוכנית Plugins Pro של סביבת העבודה. הצבת תוסף בזירת המסחר נשארת בחברות Agency. אפשר לעדכן רק תוסף שהחשבון שלכם העלה.

איך המדריך הזה?

עודכן לאחרונה ב-16 בנובמבר 2026