Разработчици

Справка за възможностите на Zinn® Reseller Toolkit

Zinn® Reseller Toolkit регистрира своите действия в WordPress Abilities API. Същите способности са MCP инструменти на собствения сървър на сайта и REST маршрути под /wp-json/wp-abilities/v1. Тази страница се генерира от собствения регистър на плъгина.

Ръководство за потребителя: свързване на AI приложение

Крайна точка

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 на плъгина, който от своя страна се генерира от работещ сайт; тестът се проваля, когато двете не съвпадат.

ВъзможностКак работиИзданиеRESTПраво на достъпПараметри
zinn-reseller/create-client
zinn-reseller-create-client
Създаване на клиент
Създава клиентски акаунт във вашия (име; 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
Списък с вашите клиенти
Показва вашите клиентски акаунти, по една страница на път (курсор, лимит).
Безплатно издание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
Промяна на настройките на инструментариума за дистрибутори
Променя настройките, които изпращате (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