توسعه‌دهندگان
مرجع قابلیت‌های 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 | ایجاد یک مشتری یک حساب مشتری زیر حساب شما ایجاد می‌کند (نام؛ 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 | فهرست مشتریان خود را تهیه کنید فهرست کردن حساب‌های مشتریان شما، یک صفحه در هر بار (نشانگر مکان، حد). | نسخه رایگان | 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؛ بازه زمانی: 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؛ دلیل: یادداشت شخصی شما، که هرگز به مشتری نمایش داده نمی‌شود). این سایت تا زمانی که رفع تعلیق شود، از سرویس‌دهی متوقف می‌شود. | نسخه رایگان | 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 | تغییر تنظیمات جعبه‌ابزار نمایندگی تنظیماتی را که ارسال می‌کنید (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 |