Sviluppatori
Riferimento capacità di Zinn® Reseller Toolkit
Zinn® Reseller Toolkit registra le proprie azioni con WordPress Abilities API. Le stesse capacità sono strumenti MCP sul server del sito e route REST sotto /wp-json/wp-abilities/v1. Questa pagina viene generata dal registro del plugin stesso.
Endpoint
MCP su HTTP (streamable)
https://example.com/wp-json/zinn-reseller/v1/mcpMCP su WP-CLI (standard input e output)
wp mcp-adapter serve --server=zinn-reseller --user=<login>REST: elenca le capacità
/wp-json/wp-abilities/v1/abilities?category=zinn-resellerREST: esegui un'abilità
/wp-json/wp-abilities/v1/abilities/<name>/runAutenticazione e autorizzazioni
Le richieste HTTP si autenticano con una password applicativa WordPress (HTTP Basic). La connessione al server MCP richiede la funzionalità mostrata di seguito; ogni abilità verifica quindi la propria autorizzazione, per singolo oggetto. Le abilità di sola lettura vengono eseguite con GET e il relativo input nella query string; le altre con POST e un corpo JSON {"input": {…}}.
Esempi
# REST: esegui un'abilità
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":{}}}Tutte le funzionalità
Generato dalle capacità del plugin tramite abilities.json, che a sua volta viene generato da un sito in esecuzione; un test fallisce quando i due non concordano.
| Abilitazione | Cosa fa | Edizione | REST | Autorizzazione | Parametri |
|---|---|---|---|---|---|
zinn-reseller/create-clientzinn-reseller-create-client | Crea un client Crea un account cliente sotto il tuo (name; default_currency, un codice di tre lettere). Assegna loro un piano prima del loro primo sito. | Edizione gratuita | POST …/abilities/zinn-reseller/create-client/run | manage_options | name: string (obbligatorio), default_currency: string |
zinn-reseller/create-sitezinn-reseller-create-site | Crea un sito per un cliente Crea un sito ospitato per uno dei tuoi clienti (client_id, product_line, primary_domain). Viene fatturato sul tuo account in base al piano del cliente, come dal tuo negozio. | Edizione gratuita | POST …/abilities/zinn-reseller/create-site/run | manage_options | client_id: string (obbligatorio), product_line: string (obbligatorio), primary_domain: string (obbligatorio) |
zinn-reseller/get-client-planzinn-reseller-get-client-plan | Leggi il piano di un cliente Restituisce quale piano ha un cliente e quanto ti costa (client_id). | Edizione gratuita | GET …/abilities/zinn-reseller/get-client-plan/run | manage_options | client_id: string (obbligatorio) |
zinn-reseller/get-overviewzinn-reseller-get-overview | Leggi il tuo account rivenditore Restituisce il tuo account rivenditore in una sola lettura: brand, piani, numero di clienti e servizi e cosa è configurato. | Edizione gratuita | GET …/abilities/zinn-reseller/get-overview/run | manage_options | nessuno |
zinn-reseller/get-settingszinn-reseller-get-settings | Leggi le impostazioni del Reseller Toolkit Restituisce le impostazioni di questo plugin (l'indirizzo dell'API, il piano utilizzato dai nuovi ordini, quali funzionalità sono attive). La chiave API non viene mai restituita, ma solo se ne è stata salvata una. | Edizione gratuita | GET …/abilities/zinn-reseller/get-settings/run | manage_options | nessuno |
zinn-reseller/list-clientszinn-reseller-list-clients | Elenca i tuoi clienti Elenca i tuoi account cliente, una pagina alla volta (cursor, limit). | Edizione gratuita | GET …/abilities/zinn-reseller/list-clients/run | manage_options | cursor: string, limit: integer |
zinn-reseller/list-planszinn-reseller-list-plans | Elenca i piani che puoi vendere Elenca i piani di hosting e i relativi prezzi (product_line e currency lo restringono). | Edizione gratuita | GET …/abilities/zinn-reseller/list-plans/run | manage_options | product_line: string, currency: string |
zinn-reseller/list-siteszinn-reseller-list-sites | Elenca i siti dei tuoi clienti Elenca tutto ciò che hai fornito per i tuoi clienti (client_id e status lo restringono), una pagina alla volta. | Edizione gratuita | GET …/abilities/zinn-reseller/list-sites/run | manage_options | cursor: string, limit: integer, client_id: string, status: string |
zinn-reseller/set-client-planzinn-reseller-set-client-plan | Assegna un piano a un cliente Associa un cliente a uno dei tuoi piani (client_id, plan_code; interval: month o year). Esegui questa operazione prima del suo primo sito. | Edizione gratuita | POST …/abilities/zinn-reseller/set-client-plan/run | manage_options | client_id: string (obbligatorio), plan_code: string (obbligatorio), interval: month|year |
zinn-reseller/suspend-sitezinn-reseller-suspend-site | Sospendi il sito di un cliente Mette il sito di un cliente in sospensione per mancato pagamento (site_id; reason: la tua nota personale, mai mostrata al cliente). Il sito smette di funzionare finché non viene revocata la sospensione. | Edizione gratuita | POST …/abilities/zinn-reseller/suspend-site/run | manage_options | site_id: string (obbligatorio), reason: string |
zinn-reseller/unsuspend-sitezinn-reseller-unsuspend-site | Riattiva il sito di un cliente Rimuove un blocco per mancato pagamento, così il sito torna a essere attivo (site_id). | Edizione gratuita | POST …/abilities/zinn-reseller/unsuspend-site/run | manage_options | site_id: string (obbligatorio) |
zinn-reseller/update-settingszinn-reseller-update-settings | Modifica le impostazioni di Reseller Toolkit Modifica le impostazioni che invii (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce) e mantiene le altre. La chiave API e l'indirizzo vengono modificati solo sullo schermo. | Edizione gratuita | POST …/abilities/zinn-reseller/update-settings/run | manage_options | plan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean |