توسعهدهندگان
مرجع قابلیتهای Zinn® Reseller Toolkit
Zinn® Reseller Toolkit کنشهای خود را در API توانمندیهای WordPress ثبت میکند. همین توانمندیها ابزارهای 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) احراز هویت میشوند. اتصال به سرور 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 | خواندن تنظیمات Reseller Toolkit تنظیمات این افزونه را برمیگرداند (نشانی 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 |