توسعه‌دهندگان

مرجع قابلیت‌های Zinn® Reseller Toolkit

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