דילוג לתוכן

Marketplace

מכירת האפליקציות שלכם ללקוחות Xuda.

פתיחת Marketplace
נבדק מול לוח הבקרה ב-19 בנובמבר 2026

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

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

עוברים על הקטלוג ומתקינים

עוברים על הקטלוג

get_plugins מחזירה את הקטלוג הציבורי (רק פריטים שאושרו ואינם פרטיים, אלא אם מעבירים uid משלכם), שאפשר לסנן לפי category, tags והתאמת טקסט חופשי, ו-get_plugins_categories מחזירה את היבטי הקטגוריות עם הספירות שלהם.

רואים מה כבר יש בפרויקט

get_app_plugins מפרטת מה פרויקט התקין.

מתקינים

install_plugin מתקינה תוסף בשם על app_id. uninstall_plugin מסירה אחד.

curl -s https://xuda.ai/cpi/install_plugin \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","app_id":"YOUR_APP_ID","plugin_name":"@xuda.io/example-plugin"}'
const res = await fetch('https://xuda.ai/cpi/install_plugin', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    app_id: 'YOUR_APP_ID',
    plugin_name: '@xuda.io/example-plugin',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/install_plugin',
    json={'api_key': 'YOUR_API_KEY', 'app_id': 'YOUR_APP_ID', 'plugin_name': '@xuda.io/example-plugin'},
)
המזהים מוחזרים בלי ה-scope

get_plugins מסירה את קידומת ה-scope @xuda.io/ מה-_id שהיא מחזירה. מוסיפים אותה בחזרה כשמעבירים שם של תוסף ל-install_plugin.

get_install_consent, במיקרו-שירות Marketplace עצמו, מחזירה את מסך ההסכמה לסוכן AI אחד או לתוסף אחד: מה הוא עושה, מי פרסם אותו, טקסט האחריות, וגיבוב התוכן ש-install צריכה להחזיר, לפני ש-install_plugin רצה.

מפרסמים תוסף

upload_plugin יוצרת או מעדכנת את מסמך הפריט של תוסף בעצמו, ומעלה את החבילה והמטא-דאטה שלו. הצבת תוסף ב-Marketplace דורשת את התוכנית Agency ומעלה. העלאה פרטית מותרת גם על ידי התוכנית Plugins של סביבת העבודה שמעלים אליה. שליחת visibility: "private" או skip_publish_review: true שומרת אותו מחוץ לתור הבדיקה ומחוץ לקטלוג הציבורי, לעדכון קוד או npm שלא צריך לפתוח מחדש בדיקה.

פריטים שאתם מוכרים

פריטים של האפליקציות שלכם, כפי שדף Marketplace יוצר אותם, מנוהלים מהדשבורד: חלון הפריט ודף הפריט החדש עושים זאת בקרה אחר בקרה. תוכנית המוכר שלכם נמצאת בחלון התוכניות.

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

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