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

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
Creați un client
Creează un cont de client sub al tău (nume; default_currency, un cod din trei litere). Treci-l pe un abonament înainte de primul său 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
Creați un site pentru un client
Creează un site găzduit pentru unul dintre clienții dvs. (client_id, product_line, primary_domain). Ac Acesta este facturat în contul dvs. la planul clientului, ca de la magazinul dvs.
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
Vizualizați planul unui client
Returnează abonamentul pe care se află un client și costul acestuia pentru tine (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
Citiți contul dvs. de reseller
Întoarce contul tău de reseller dintr-o singură citire: marca, planurile, numărul de clienți și servicii și ce este configurat.
Ediție gratuităGET …/abilities/zinn-reseller/get-overview/runmanage_optionsniciunul
zinn-reseller/get-settings
zinn-reseller-get-settings
Citiți setările pentru Kitul de instrumente pentru revânzători
Returnează setările acestui modul (adresa API, planul folosit de comenzile noi, ce funcții sunt activate). Cheia API nu este returnată niciodată, ci doar dacă una este salvată.
Ediție gratuităGET …/abilities/zinn-reseller/get-settings/runmanage_optionsniciunul
zinn-reseller/list-clients
zinn-reseller-list-clients
Listați-vă clienții
Listează conturile clienților tăi, câte o pagină (cursor, limit).
Ediție gratuităGET …/abilities/zinn-reseller/list-clients/runmanage_optionscursor: string, limit: integer
zinn-reseller/list-plans
zinn-reseller-list-plans
Listați planurile pe care le puteți vinde
Listează planurile de găzduire și prețurile acestora (product_line și currency le restrâng).
Ediție gratuităGET …/abilities/zinn-reseller/list-plans/runmanage_optionsproduct_line: string, currency: string
zinn-reseller/list-sites
zinn-reseller-list-sites
Listați site-urile clienților dumneavoastră
Afișează tot ce ați configurat pentru clienții dumneavoastră (client_id și status restrâng rezultatele), câte o pagină.
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
Atribuiți un client la un abonament
Pune un client pe unul dintre planurile tale (client_id, plan_code; interval: lună sau an). 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
Suspendarea site-ului unui client
Pune site-ul unui client în așteptare pentru neplată (site_id; motiv: propria ta notă, care nu îi este afișată niciodată clientului). Site-ul nu mai funcționează până când este reactivat.
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
Ridică o blocare 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
Schimbați setările pentru Setul de unelte pentru revânzători
Modifică setările pe care le trimiți (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce) și le păstrează pe celelalte. 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