מפתחים

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

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

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

⁦Zinn®⁩, הוויקינג שלנו, מריע כאשר עוזר בינה מלאכותית מתחבר לכלי הפלטפורמה.

נקודות קצה

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
יצירת לקוח
יוצר חשבון לקוח תחת החשבון שלכם (name; default_currency, קוד בן שלוש אותיות). שייכו אותם לתוכנית לפני האתר הראשון שלהם.
מהדורה חינמיתPOST …/abilities/zinn-reseller/create-client/runmanage_optionsname: string (נדרש), default_currency: string
zinn-reseller/create-site
zinn-reseller-create-site
יצירת אתר עבור לקוח
יוצר אתר מאוחסן עבור אחד מלקוחותיך (client_id, product_line, primary_domain). החיוב מתבצע לחשבונך לפי תוכנית הלקוח, כמו מהחנות שלך.
מהדורה חינמיתPOST …/abilities/zinn-reseller/create-site/runmanage_optionsclient_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/runmanage_optionsclient_id: string (נדרש)
zinn-reseller/get-overview
zinn-reseller-get-overview
קריאת חשבון המפיץ שלך
מחזיר את חשבון המפיץ שלך בקריאה אחת: מותג, תוכניות, ספירת לקוחות ושירותים, ומה שמוגדר.
מהדורה חינמיתGET …/abilities/zinn-reseller/get-overview/runmanage_optionsללא
zinn-reseller/get-settings
zinn-reseller-get-settings
קרא את הגדרות ערכת הכלים למשווקים
מחזיר את הגדרות התוסף הזה (כתובת ה-API, התוכנית שבה משתמשות הזמנות חדשות, ואילו תכונות מופעלות). מפתח ה-API לעולם אינו מוחזר, אלא רק אם שמור כזה.
מהדורה חינמיתGET …/abilities/zinn-reseller/get-settings/runmanage_optionsללא
zinn-reseller/list-clients
zinn-reseller-list-clients
הצגת הלקוחות שלך
מפרט את חשבונות הלקוח שלך, עמוד אחד בכל פעם (cursor, limit).
מהדורה חינמיתGET …/abilities/zinn-reseller/list-clients/runmanage_optionscursor: string, limit: integer
zinn-reseller/list-plans
zinn-reseller-list-plans
הצגת התוכניות שבאפשרותך למכור
מציג את חבילות האחסון והמחירים שלהן (product_line ו-currency מצמצמים את התוצאות).
מהדורה חינמיתGET …/abilities/zinn-reseller/list-plans/runmanage_optionsproduct_line: string, currency: string
zinn-reseller/list-sites
zinn-reseller-list-sites
הצגת אתרי הלקוחות שלך
מפרט כל מה שהקצאת עבור הלקוחות שלך (client_id ו-status מצמצמים את התוצאות), עמוד אחד בכל פעם.
מהדורה חינמיתGET …/abilities/zinn-reseller/list-sites/runmanage_optionscursor: string, limit: integer, client_id: string, status: string
zinn-reseller/set-client-plan
zinn-reseller-set-client-plan
הקצאת תוכנית ללקוח
משייך לקוח לאחת מהתוכניות שלך (client_id, plan_code; interval: month או year). יש לבצע זאת לפני האתר הראשון שלהם.
מהדורה חינמיתPOST …/abilities/zinn-reseller/set-client-plan/runmanage_optionsclient_id: string (נדרש), plan_code: string (נדרש), interval: month|year
zinn-reseller/suspend-site
zinn-reseller-suspend-site
השהיית אתר לקוח
מעביר את האתר של לקוח להשהיה עקב אי-תשלום (site_id; reason: הערה משלך, שלעולם אינה מוצגת ללקוח). האתר מפסיק לפעול עד לביטול ההשעיה.
מהדורה חינמיתPOST …/abilities/zinn-reseller/suspend-site/runmanage_optionssite_id: string (נדרש), reason: string
zinn-reseller/unsuspend-site
zinn-reseller-unsuspend-site
בטל השעיה של אתר לקוח
מסיר השהיה עקב אי-תשלום, כך שהאתר חוזר לפעול (site_id).
מהדורה חינמיתPOST …/abilities/zinn-reseller/unsuspend-site/runmanage_optionssite_id: string (נדרש)
zinn-reseller/update-settings
zinn-reseller-update-settings
שינוי הגדרות Reseller Toolkit
משנה את ההגדרות שאתה שולח (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce) ושומר את השאר. מפתח ה-API והכתובת משתנים במסך בלבד.
מהדורה חינמיתPOST …/abilities/zinn-reseller/update-settings/runmanage_optionsplan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean