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.

Guida utente: collega un'app di IA

Zinn®, il nostro vichingo, esulta mentre un assistente IA si connette agli strumenti della piattaforma.

Endpoint

MCP su HTTP (streamable)

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

MCP 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-reseller

REST: esegui un'abilità

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

Autenticazione 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.

AbilitazioneCosa faEdizioneRESTAutorizzazioneParametri
zinn-reseller/create-client
zinn-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 gratuitaPOST …/abilities/zinn-reseller/create-client/runmanage_optionsname: string (obbligatorio), default_currency: string
zinn-reseller/create-site
zinn-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 gratuitaPOST …/abilities/zinn-reseller/create-site/runmanage_optionsclient_id: string (obbligatorio), product_line: string (obbligatorio), primary_domain: string (obbligatorio)
zinn-reseller/get-client-plan
zinn-reseller-get-client-plan
Leggi il piano di un cliente
Restituisce quale piano ha un cliente e quanto ti costa (client_id).
Edizione gratuitaGET …/abilities/zinn-reseller/get-client-plan/runmanage_optionsclient_id: string (obbligatorio)
zinn-reseller/get-overview
zinn-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 gratuitaGET …/abilities/zinn-reseller/get-overview/runmanage_optionsnessuno
zinn-reseller/get-settings
zinn-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 gratuitaGET …/abilities/zinn-reseller/get-settings/runmanage_optionsnessuno
zinn-reseller/list-clients
zinn-reseller-list-clients
Elenca i tuoi clienti
Elenca i tuoi account cliente, una pagina alla volta (cursor, limit).
Edizione gratuitaGET …/abilities/zinn-reseller/list-clients/runmanage_optionscursor: string, limit: integer
zinn-reseller/list-plans
zinn-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 gratuitaGET …/abilities/zinn-reseller/list-plans/runmanage_optionsproduct_line: string, currency: string
zinn-reseller/list-sites
zinn-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 gratuitaGET …/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
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 gratuitaPOST …/abilities/zinn-reseller/set-client-plan/runmanage_optionsclient_id: string (obbligatorio), plan_code: string (obbligatorio), interval: month|year
zinn-reseller/suspend-site
zinn-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 gratuitaPOST …/abilities/zinn-reseller/suspend-site/runmanage_optionssite_id: string (obbligatorio), reason: string
zinn-reseller/unsuspend-site
zinn-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 gratuitaPOST …/abilities/zinn-reseller/unsuspend-site/runmanage_optionssite_id: string (obbligatorio)
zinn-reseller/update-settings
zinn-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 gratuitaPOST …/abilities/zinn-reseller/update-settings/runmanage_optionsplan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean