מפתחים

הפניות ליכולות של Zinn® Reseller Toolkit

Zinn® Reseller Toolkit רושם את הפעולות שלו באמצעות ה-WordPress Abilities API. אותן יכולות הן כלי MCP בשרת של האתר עצמו ונתיבי REST תחת /wp-json/wp-abilities/v1. דף זה מופק מתוך הרישום של התוסף עצמו.

מדריך למשתמש: חיבור אפליקציית בינה מלאכותית

נקודות קצה

MCP דרך HTTP (ניתן להזרמה)

https://example.com/wp-json/zinn-reseller/v1/mcp

MCP מעל WP-CLI (קלט ופלט סטנדרטיים)

wp mcp-adapter serve --server=zinn-reseller --user=<login>

REST: הצג רשימת יכולות

/wp-json/wp-abilities/v1/abilities?category=zinn-reseller

REST: הרצת יכולת

/wp-json/wp-abilities/v1/abilities/<name>/run

אימות והרשאות

בקשות HTTP מבצעות אימות באמצעות סיסמת אפליקציה של WordPress (HTTP Basic). התחברות לשרת ה-MCP דורשת את ההרשאה המוצגת להלן; לאחר מכן, כל יכולת בודקת את ההרשאה שלה, לפי אובייקט. יכולות לקריאה בלבד פועלות עם GET והקלט שלהן במחרוזת השילתא (query string); השאר פועלות עם POST וגוף JSON של {"input": {…}}.

דוגמאות

# REST: הרצת יכולת
curl -u your-username:your-application-password \
  "https://example.com/wp-json/wp-abilities/v1/abilities/zinn-reseller/get-overview/run"

# MCP (JSON-RPC over HTTP, after "initialize")
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"zinn-reseller-get-overview","arguments":{}}}

כל היכולות

נוצר מתוך קובץ ה-abilities.json של התוסף, המיוצר בעצמו מאתר רץ; בדיקה נכשלת כאשר השניים אינם תואמים.

הרשאה	מה זה עושה	מהדורה	מנוחה	הרשאה	פרמטרים
`zinn-reseller/create-client` `zinn-reseller-create-client`	יצירת לקוח יוצר חשבון לקוח תחת החשבון שלך (שם; default_currency, קוד בת שלושה תווים). יש להקצות לו תוכנית לפני האתר הראשון שלו.	מהדורה חינמית	`POST …/abilities/zinn-reseller/create-client/run`	manage_options	name: string (נדרש), default_currency: string
`zinn-reseller/create-site` `zinn-reseller-create-site`	יצירת אתר עבור לקוח יוצר אתר מאוחסן עבור אחד מהלקוחות שלך (client_id, product_line, primary_domain). החיוב מתבצע בחשבון שלך לפי תוכנית הלקוח, כמו מהחנות שלך.	מהדורה חינמית	`POST …/abilities/zinn-reseller/create-site/run`	manage_options	client_id: string (נדרש), product_line: string (נדרש), primary_domain: string (נדרש)
`zinn-reseller/get-client-plan` `zinn-reseller-get-client-plan`	קריאת התוכנית של לקוח מחזיר באיזו תוכנית נמצא הלקוח ומה העלות שלה עבורך (client_id).	מהדורה חינמית	`GET …/abilities/zinn-reseller/get-client-plan/run`	manage_options	client_id: string (נדרש)
`zinn-reseller/get-overview` `zinn-reseller-get-overview`	קרא את חשבון המשווק שלך מחזיר את חשבון המשווק שלך במבט אחד: מותג, תוכניות, ספירת לקוחות ושירותים, ומה מוגדר.	מהדורה חינמית	`GET …/abilities/zinn-reseller/get-overview/run`	manage_options	ללא
`zinn-reseller/get-settings` `zinn-reseller-get-settings`	קרא את הגדרות ערכת הכלים של המשווק המורשה מחזיר את ההגדרות של תוסף זה (כתובת ה-API, התוכנית שבה משתמשים הזמנות חדשות, אילו תכונות מופעלות). מפתח ה-API לעולם אינו מוחזר, אלא רק האם הוא נשמר.	מהדורה חינמית	`GET …/abilities/zinn-reseller/get-settings/run`	manage_options	ללא
`zinn-reseller/list-clients` `zinn-reseller-list-clients`	הצג את הלקוחות שלך מציג את חשבונות הלקוחות שלך, עמוד אחד בכל פעם (סמן, הגבלה).	מהדורה חינמית	`GET …/abilities/zinn-reseller/list-clients/run`	manage_options	cursor: string, limit: integer
`zinn-reseller/list-plans` `zinn-reseller-list-plans`	הצג את התוכניות שבאפשרותך למכור מציג את תוכניות האחסון ומחיריהן (product_line ו-currency מצמצמים את התוצאות).	מהדורה חינמית	`GET …/abilities/zinn-reseller/list-plans/run`	manage_options	product_line: string, currency: string
`zinn-reseller/list-sites` `zinn-reseller-list-sites`	הצג את האתרים של הלקוחות שלך מציג את כל מה שהקצית עבור הלקוחות שלך (client_id ו-status מצמצמים את התוצאות), עמוד אחר עמוד.	מהדורה חינמית	`GET …/abilities/zinn-reseller/list-sites/run`	manage_options	cursor: string, limit: integer, client_id: string, status: string
`zinn-reseller/set-client-plan` `zinn-reseller-set-client-plan`	שייך לקוח לתוכנית מצרף לקוח לאחד מהמסלולים שלך (client_id, plan_code; interval: חודש או שנה). עשה זאת לפני האתר הראשון שלו.	מהדורה חינמית	`POST …/abilities/zinn-reseller/set-client-plan/run`	manage_options	client_id: string (נדרש), plan_code: string (נדרש), interval: month\|year
`zinn-reseller/suspend-site` `zinn-reseller-suspend-site`	השבתת האתר של לקוח מעביר את האתר של לקוח למצב השהיה עקב אי-תשלום (site_id; סיבה: הערה פנימית שלך, לעולם אינה מוצגת ללקוח). האתר יפסיק לפעול עד לביטול ההשהיה.	מהדורה חינמית	`POST …/abilities/zinn-reseller/suspend-site/run`	manage_options	site_id: string (נדרש), reason: string
`zinn-reseller/unsuspend-site` `zinn-reseller-unsuspend-site`	ביטול השעיית אתר של לקוח מסיר את החסימה בגין אי-תשלום, כך שהאתר יפעל שוב (site_id).	מהדורה חינמית	`POST …/abilities/zinn-reseller/unsuspend-site/run`	manage_options	site_id: string (נדרש)
`zinn-reseller/update-settings` `zinn-reseller-update-settings`	שנה את הגדרות ערכת הכלים של המשווק משנה את ההגדרות שאתה שולח (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce) ושומר את השאר. מפתח ה-API והכתובת משנות במסך בלבד.	מהדורה חינמית	`POST …/abilities/zinn-reseller/update-settings/run`	manage_options	plan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean