Desenvolvedores
Referência de capacidades de Zinn® Reseller Toolkit
Zinn® Reseller Toolkit registra suas ações na WordPress Abilities API. As mesmas habilidades são ferramentas de MCP no próprio servidor do site e rotas REST em /wp-json/wp-abilities/v1. Esta página é gerada a partir do registro do próprio plugin.
Endpoints
MCP sobre HTTP (streaming)
https://example.com/wp-json/zinn-reseller/v1/mcpMCP sobre WP-CLI (entrada e saída padrão)
wp mcp-adapter serve --server=zinn-reseller --user=<login>REST: listar as habilidades
/wp-json/wp-abilities/v1/abilities?category=zinn-resellerREST: executar uma habilidade
/wp-json/wp-abilities/v1/abilities/<name>/runAutenticação e permissões
As solicitações HTTP autenticam-se com uma senha de aplicativo do WordPress (HTTP Basic). A conexão com o servidor MCP precisa do recurso mostrado abaixo; cada habilidade verifica então a sua própria permissão, por objeto. As habilidades somente leitura são executadas com GET e sua entrada na string de consulta; as demais, com POST e um corpo JSON {"input": {…}}.
Exemplos
# REST: executar uma habilidade
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":{}}}Todos os recursos
Gerado a partir do arquivo abilities.json do plugin, que por sua vez é gerado a partir de um site em execução; um teste falha quando os dois discordam.
| Recurso | O que faz | Edição | REST | Permissão | Parâmetros |
|---|---|---|---|---|---|
zinn-reseller/create-clientzinn-reseller-create-client | Criar um cliente Cria uma conta de cliente vinculada à sua (name; default_currency, um código de três letras). Adicione-os a um plano antes do primeiro site deles. | Edição gratuita | POST …/abilities/zinn-reseller/create-client/run | manage_options | name: string (obrigatório), default_currency: string |
zinn-reseller/create-sitezinn-reseller-create-site | Crie um site para um cliente Cria um site hospedado para um de seus clientes (client_id, product_line, primary_domain). Ele é faturado em sua conta de acordo com o plano do cliente, como a partir de sua loja. | Edição gratuita | POST …/abilities/zinn-reseller/create-site/run | manage_options | client_id: string (obrigatório), product_line: string (obrigatório), primary_domain: string (obrigatório) |
zinn-reseller/get-client-planzinn-reseller-get-client-plan | Ler o plano de um cliente Retorna em qual plano um cliente está e quanto isso custa para você (client_id). | Edição gratuita | GET …/abilities/zinn-reseller/get-client-plan/run | manage_options | client_id: string (obrigatório) |
zinn-reseller/get-overviewzinn-reseller-get-overview | Ler sua conta de revendedor Retorna sua conta de revendedor em uma única leitura: marca, planos, contagem de clientes e serviços e o que está configurado. | Edição gratuita | GET …/abilities/zinn-reseller/get-overview/run | manage_options | nenhum |
zinn-reseller/get-settingszinn-reseller-get-settings | Leia as configurações do Reseller Toolkit Retorna as configurações deste plugin (o endereço da API, o plano usado pelos novos pedidos, quais recursos estão ativados). A chave de API nunca é retornada, apenas se há uma salva. | Edição gratuita | GET …/abilities/zinn-reseller/get-settings/run | manage_options | nenhum |
zinn-reseller/list-clientszinn-reseller-list-clients | Listar seus clientes Lista as suas contas de clientes, uma página por vez (cursor, limit). | Edição gratuita | GET …/abilities/zinn-reseller/list-clients/run | manage_options | cursor: string, limit: integer |
zinn-reseller/list-planszinn-reseller-list-plans | Liste os planos que você pode vender Lista os planos de hospedagem e seus preços (product_line e currency limitam o resultado). | Edição gratuita | GET …/abilities/zinn-reseller/list-plans/run | manage_options | product_line: string, currency: string |
zinn-reseller/list-siteszinn-reseller-list-sites | Listar os sites dos seus clientes Lista tudo o que você provisionou para seus clientes (client_id e status refinam a busca), uma página por vez. | Edição 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 | Atribua um plano a um cliente Atribui um cliente a um dos seus planos (client_id, plan_code; interval: month ou year). Faça isso antes do primeiro site dele. | Edição gratuita | POST …/abilities/zinn-reseller/set-client-plan/run | manage_options | client_id: string (obrigatório), plan_code: string (obrigatório), interval: month|year |
zinn-reseller/suspend-sitezinn-reseller-suspend-site | Suspender o site de um cliente Coloca o site de um cliente em retenção por falta de pagamento (site_id; reason: sua própria nota, nunca exibida ao cliente). O site para de funcionar até que a suspensão seja removida. | Edição gratuita | POST …/abilities/zinn-reseller/suspend-site/run | manage_options | site_id: string (obrigatório), reason: string |
zinn-reseller/unsuspend-sitezinn-reseller-unsuspend-site | Reativar o site de um cliente Remove o bloqueio por falta de pagamento para que o site volte a funcionar (site_id). | Edição gratuita | POST …/abilities/zinn-reseller/unsuspend-site/run | manage_options | site_id: string (obrigatório) |
zinn-reseller/update-settingszinn-reseller-update-settings | Alterar as configurações do Reseller Toolkit Altera as configurações que você envia (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce) e mantém o restante. A chave de API e o endereço são alterados apenas na tela. | Edição gratuita | POST …/abilities/zinn-reseller/update-settings/run | manage_options | plan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean |