Әзірлеушілер

Zinn® Reseller Toolkit мүмкіндіктерінің анықтамасы

Zinn® Reseller Toolkit өз әрекеттерін WordPress Abilities API арқылы тіркейді. Сол қабілеттер сайттың өз серверіндегі MCP құралдары және /wp-json/wp-abilities/v1 астындағы REST бағыттары болып табылады. Бұл бет плагин өз тізілімінен жасалған.

Пайдаланушы нұсқаулығы: ЖИ қолданбасын қосу

Соңғы нүктелер

HTTP арқылы MCP (ағынды)

https://example.com/wp-json/zinn-reseller/v1/mcp

WP-CLI арқылы MCP (standard input және standard output)

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 әдісімен және кірісі сұрау жолағында берілген күйде жұмыс істейді; қалғандары POST әдісімен және {"input": {…}} JSON негізгі бөлігімен жұмыс істейді.

Мысалдар

# 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`	Клиентті жасау Сіздің аккаунтыңыздың астында клиент аккаунтын жасайды (name; default_currency, үш әріпті код). Бірінші сайтын жасамас бұрын оларды жоспарға қойыңыз.	Тегін шығарылым	`POST …/abilities/zinn-reseller/create-client/run`	manage_options	name: string (міндетті), default_currency: string
`zinn-reseller/create-site` `zinn-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-plan` `zinn-reseller-get-client-plan`	Клиенттің жоспарын оқу Клиенттің қай жоспарда екенін және ол сізге қанша тұратынын қайтарады (client_id).	Тегін шығарылым	`GET …/abilities/zinn-reseller/get-client-plan/run`	manage_options	client_id: string (міндетті)
`zinn-reseller/get-overview` `zinn-reseller-get-overview`	Реселлер тіркелгіңізді оқыңыз Reseller тіркелгіңізді бір оқуда қайтарады: бренд, жоспарлар, клиенттер мен қызметтер саны және не орнатылғаны.	Тегін шығарылым	`GET …/abilities/zinn-reseller/get-overview/run`	manage_options	жоқ
`zinn-reseller/get-settings` `zinn-reseller-get-settings`	Реселлер құралдар жинағы параметрлерін оқу Бұл плагин параметрлерін қайтарады (API мекенжайы, жаңа тапсырыстар пайдаланатын жоспар, қай мүмкіндіктер қосылғаны). API кілті ешқашан қайтарылмайды, тек сақталғаны не сақталмағаны ғана көрсетіледі.	Тегін шығарылым	`GET …/abilities/zinn-reseller/get-settings/run`	manage_options	жоқ
`zinn-reseller/list-clients` `zinn-reseller-list-clients`	Клиенттеріңіздің тізімін жасаңыз Клиенттік тіркелгілеріңізді бір беттен тізімдейді (cursor, limit).	Тегін шығарылым	`GET …/abilities/zinn-reseller/list-clients/run`	manage_options	cursor: string, limit: integer
`zinn-reseller/list-plans` `zinn-reseller-list-plans`	Сатуға болатын жоспарларды тізімдеңіз Хостинг жоспарларын және олардың бағаларын көрсетеді (product_line және currency параметрлері оны нақтылайды).	Тегін шығарылым	`GET …/abilities/zinn-reseller/list-plans/run`	manage_options	product_line: string, currency: string
`zinn-reseller/list-sites` `zinn-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-plan` `zinn-reseller-set-client-plan`	Клиентті тарифке қосу Клиенттің біздің жоспарларыңыздың біріне қосу (client_id, plan_code; аралық: ай немесе жыл). Мұны бірінші сайтының алдында орындаңыз.	Тегін шығарылым	`POST …/abilities/zinn-reseller/set-client-plan/run`	manage_options	client_id: string (міндетті), plan_code: string (міндетті), interval: month\|year
`zinn-reseller/suspend-site` `zinn-reseller-suspend-site`	Клиент сайтын уақытша тоқтату Клиенттің сайтын төлем төлемегені үшін бұғаттауға қояды (site_id; себебі: сіздің жеке жазбаңыз, клиентке ешқашан көрсетілмейді). Сайт жүйеден алынғанша жұмыс істеуін тоқтатады.	Тегін шығарылым	`POST …/abilities/zinn-reseller/suspend-site/run`	manage_options	site_id: string (міндетті), reason: string
`zinn-reseller/unsuspend-site` `zinn-reseller-unsuspend-site`	Клиент сайтының бұғаттауын алу Төлем қажеттілігіне байланысты қойылған шектеуді алып тастайды, нәтижесінде сайт қайтадан жұмыс істей бастайды (site_id).	Тегін шығарылым	`POST …/abilities/zinn-reseller/unsuspend-site/run`	manage_options	site_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/run`	manage_options	plan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean