מפתחים
הפניות ליכולות של 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/mcpMCP מעל WP-CLI (קלט ופלט סטנדרטיים)
wp mcp-adapter serve --server=zinn-reseller --user=<login>REST: הצג רשימת יכולות
/wp-json/wp-abilities/v1/abilities?category=zinn-resellerREST: הרצת יכולת
/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-clientzinn-reseller-create-client | יצירת לקוח יוצר חשבון לקוח תחת החשבון שלכם (name; default_currency, קוד בן שלוש אותיות). שייכו אותם לתוכנית לפני האתר הראשון שלהם. | מהדורה חינמית | POST …/abilities/zinn-reseller/create-client/run | manage_options | name: string (נדרש), default_currency: string |
zinn-reseller/create-sitezinn-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-planzinn-reseller-get-client-plan | קריאת תוכנית של לקוח מחזיר את התוכנית שבה הלקוח נמצא ומה העלות שלה עבורך (client_id). | מהדורה חינמית | GET …/abilities/zinn-reseller/get-client-plan/run | manage_options | client_id: string (נדרש) |
zinn-reseller/get-overviewzinn-reseller-get-overview | קריאת חשבון המפיץ שלך מחזיר את חשבון המפיץ שלך בקריאה אחת: מותג, תוכניות, ספירת לקוחות ושירותים, ומה שמוגדר. | מהדורה חינמית | GET …/abilities/zinn-reseller/get-overview/run | manage_options | ללא |
zinn-reseller/get-settingszinn-reseller-get-settings | קרא את הגדרות ערכת הכלים למשווקים מחזיר את הגדרות התוסף הזה (כתובת ה-API, התוכנית שבה משתמשות הזמנות חדשות, ואילו תכונות מופעלות). מפתח ה-API לעולם אינו מוחזר, אלא רק אם שמור כזה. | מהדורה חינמית | GET …/abilities/zinn-reseller/get-settings/run | manage_options | ללא |
zinn-reseller/list-clientszinn-reseller-list-clients | הצגת הלקוחות שלך מפרט את חשבונות הלקוח שלך, עמוד אחד בכל פעם (cursor, limit). | מהדורה חינמית | GET …/abilities/zinn-reseller/list-clients/run | manage_options | cursor: string, limit: integer |
zinn-reseller/list-planszinn-reseller-list-plans | הצגת התוכניות שבאפשרותך למכור מציג את חבילות האחסון והמחירים שלהן (product_line ו-currency מצמצמים את התוצאות). | מהדורה חינמית | GET …/abilities/zinn-reseller/list-plans/run | manage_options | product_line: string, currency: string |
zinn-reseller/list-siteszinn-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-planzinn-reseller-set-client-plan | הקצאת תוכנית ללקוח משייך לקוח לאחת מהתוכניות שלך (client_id, plan_code; interval: month או year). יש לבצע זאת לפני האתר הראשון שלהם. | מהדורה חינמית | POST …/abilities/zinn-reseller/set-client-plan/run | manage_options | client_id: string (נדרש), plan_code: string (נדרש), interval: month|year |
zinn-reseller/suspend-sitezinn-reseller-suspend-site | השהיית אתר לקוח מעביר את האתר של לקוח להשהיה עקב אי-תשלום (site_id; reason: הערה משלך, שלעולם אינה מוצגת ללקוח). האתר מפסיק לפעול עד לביטול ההשעיה. | מהדורה חינמית | POST …/abilities/zinn-reseller/suspend-site/run | manage_options | site_id: string (נדרש), reason: string |
zinn-reseller/unsuspend-sitezinn-reseller-unsuspend-site | בטל השעיה של אתר לקוח מסיר השהיה עקב אי-תשלום, כך שהאתר חוזר לפעול (site_id). | מהדורה חינמית | POST …/abilities/zinn-reseller/unsuspend-site/run | manage_options | site_id: string (נדרש) |
zinn-reseller/update-settingszinn-reseller-update-settings | שינוי הגדרות Reseller Toolkit משנה את ההגדרות שאתה שולח (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 |