Dezvoltatori

Referință privind capacitățile Zinn® Reseller Toolkit

Zinn® Reseller Toolkit își înregistrează acțiunile în WordPress Abilities API. Aceleași capacități sunt instrumente MCP pe propriul server al site-ului și rute REST sub /wp-json/wp-abilities/v1. Această pagină este generată din propriul registru al pluginului.

Ghidul utilizatorului: conectarea unei aplicații AI

Zinn®, vikingul nostru, aclamă în timp ce un asistent IA se conectează la instrumentele platformei.

Puncte finale

MCP prin HTTP (streamabil)

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

MCP prin WP-CLI (intrare și ieșire standard)

wp mcp-adapter serve --server=zinn-reseller --user=<login>

REST: listați capabilitățile

/wp-json/wp-abilities/v1/abilities?category=zinn-reseller

REST: rulează o abilitate

/wp-json/wp-abilities/v1/abilities/<name>/run

Autentificare și permisiuni

Cererile HTTP se autentifică cu o parolă de aplicație WordPress (HTTP Basic). Conectarea la serverul MCP necesită capabilitatea afișată mai jos; fiecare abilitate își verifică apoi propria permisiune, per obiect. Abilitățile doar pentru citire rulează cu GET și datele de intrare în șirul de interogare; celelalte cu POST și un corp JSON {„input”: {…}}.

Exemple

# REST: rulează o abilitate
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":{}}}

Toate abilitățile

Generat din fișierul abilities.json al pluginului, care la rândul său este generat dintr-un site în execuție; un test eșuează atunci când cele două nu concordă.

CapacitateCe faceEdițieRESTPermisiuneParametri
zinn-reseller/create-client
zinn-reseller-create-client
Creează un client
Creează un cont de client sub al tău (name; default_currency, un cod din trei litere). Adaugă-i la un plan înainte de primul lor site.
Ediție gratuităPOST …/abilities/zinn-reseller/create-client/runmanage_optionsname: string (obligatoriu), default_currency: string
zinn-reseller/create-site
zinn-reseller-create-site
Creează un site pentru un client
Creează un site găzduit pentru unul dintre clienții tăi (client_id, product_line, primary_domain). Este facturat în contul tău conform planului clientului, ca din magazinul tău.
Ediție gratuităPOST …/abilities/zinn-reseller/create-site/runmanage_optionsclient_id: string (obligatoriu), product_line: string (obligatoriu), primary_domain: string (obligatoriu)
zinn-reseller/get-client-plan
zinn-reseller-get-client-plan
Citește planul unui client
Returnează planul pe care îl are un client și cât te costă (client_id).
Ediție gratuităGET …/abilities/zinn-reseller/get-client-plan/runmanage_optionsclient_id: string (obligatoriu)
zinn-reseller/get-overview
zinn-reseller-get-overview
Citește-ți contul de revânzător
Îți returnează contul de revânzător într-o singură citire: marca, planurile, numărul de clienți și servicii, precum și ceea ce este configurat.
Ediție gratuităGET …/abilities/zinn-reseller/get-overview/runmanage_optionsniciunul
zinn-reseller/get-settings
zinn-reseller-get-settings
Citește setările Reseller Toolkit
Returnează setările acestui modul (adresa API, planul utilizat de comenzile noi, ce funcționalități sunt activate). Cheia API nu este returnată niciodată, ci doar dacă este salvată una.
Ediție gratuităGET …/abilities/zinn-reseller/get-settings/runmanage_optionsniciunul
zinn-reseller/list-clients
zinn-reseller-list-clients
Listează-ți clienții
Listează conturile tale de client, câte o pagină pe rând (cursor, limit).
Ediție gratuităGET …/abilities/zinn-reseller/list-clients/runmanage_optionscursor: string, limit: integer
zinn-reseller/list-plans
zinn-reseller-list-plans
Listează planurile pe care le poți vinde
Listează planurile de găzduire și prețurile acestora (product_line și currency restrâng selecția).
Ediție gratuităGET …/abilities/zinn-reseller/list-plans/runmanage_optionsproduct_line: string, currency: string
zinn-reseller/list-sites
zinn-reseller-list-sites
Listează site-urile clienților tăi
Listează tot ce ai alocat pentru clienții tăi (client_id și status restrâng rezultatele), câte o pagină pe rând.
Ediție gratuită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
Asociază un client la un plan
Asociază un client la unul dintre planurile tale (client_id, plan_code; interval: month sau year). Fă acest lucru înainte de primul său site.
Ediție gratuităPOST …/abilities/zinn-reseller/set-client-plan/runmanage_optionsclient_id: string (obligatoriu), plan_code: string (obligatoriu), interval: month|year
zinn-reseller/suspend-site
zinn-reseller-suspend-site
Suspendă site-ul unui client
Pune site-ul unui client în așteptare pentru neplată (site_id; reason: propria ta notă, care nu este afișată niciodată clientului). Site-ul își întrerupe funcționarea până când suspendarea este anulată.
Ediție gratuităPOST …/abilities/zinn-reseller/suspend-site/runmanage_optionssite_id: string (obligatoriu), reason: string
zinn-reseller/unsuspend-site
zinn-reseller-unsuspend-site
Reactivează site-ul unui client
Elimină suspendarea pentru neplată, astfel încât site-ul să funcționeze din nou (site_id).
Ediție gratuităPOST …/abilities/zinn-reseller/unsuspend-site/runmanage_optionssite_id: string (obligatoriu)
zinn-reseller/update-settings
zinn-reseller-update-settings
Schimbă setările Reseller Toolkit
Modifică setările pe care le trimiți (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce) și le păstrează pe restul. Cheia API și adresa sunt modificate doar pe ecran.
Ediție gratuităPOST …/abilities/zinn-reseller/update-settings/runmanage_optionsplan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean