Desarrolladores
Referencia de funciones de Zinn® Reseller Toolkit
Zinn® Reseller Toolkit registra sus acciones en la WordPress Abilities API. Las mismas capacidades son herramientas MCP en el propio servidor del sitio y rutas REST bajo /wp-json/wp-abilities/v1. Esta página se genera a partir del propio registro del plugin.
Endpoints
MCP sobre HTTP (transmisible)
https://example.com/wp-json/zinn-reseller/v1/mcpMCP sobre WP-CLI (entrada y salida estándar)
wp mcp-adapter serve --server=zinn-reseller --user=<login>REST: listar las habilidades
/wp-json/wp-abilities/v1/abilities?category=zinn-resellerREST: ejecutar una habilidad
/wp-json/wp-abilities/v1/abilities/<name>/runAutenticación y permisos
Las solicitudes HTTP se autentican con una contraseña de aplicación de WordPress (HTTP Basic). Conectarse al servidor MCP requiere la capacidad que se muestra a continuación; cada función verifica luego su propio permiso, por objeto. Las funciones de solo lectura se ejecutan con GET y su entrada en la cadena de consulta; las demás con POST y un cuerpo JSON {«input»: {…}}.
Ejemplos
# REST: ejecutar una habilidad
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":{}}}Todas las capacidades
Generado a partir del archivo abilities.json del plugin, que a su vez se genera a partir de un sitio en ejecución; una prueba falla cuando ambos no coinciden.
| Capacidad | Qué hace | Edición | RESTO | Permiso | Parámetros |
|---|---|---|---|---|---|
zinn-reseller/create-clientzinn-reseller-create-client | Crea un cliente Crea una cuenta de cliente bajo la tuya (name; default_currency, un código de tres letras). Asígnales un plan antes de su primer sitio. | Edición gratuita | POST …/abilities/zinn-reseller/create-client/run | manage_options | name: string (obligatorio), default_currency: string |
zinn-reseller/create-sitezinn-reseller-create-site | Crea un sitio para un cliente Crea un sitio alojado para uno de tus clientes (client_id, product_line, primary_domain). Se factura a tu cuenta según el plan del cliente, como desde tu tienda. | Edición gratuita | POST …/abilities/zinn-reseller/create-site/run | manage_options | client_id: string (obligatorio), product_line: string (obligatorio), primary_domain: string (obligatorio) |
zinn-reseller/get-client-planzinn-reseller-get-client-plan | Lee el plan de un cliente Devuelve qué plan tiene un cliente y cuánto te cuesta (client_id). | Edición gratuita | GET …/abilities/zinn-reseller/get-client-plan/run | manage_options | client_id: string (obligatorio) |
zinn-reseller/get-overviewzinn-reseller-get-overview | Lee tu cuenta de distribuidor Devuelve tu cuenta de distribuidor en una sola lectura: marca, planes, recuento de clientes y servicios, y lo que está configurado. | Edición gratuita | GET …/abilities/zinn-reseller/get-overview/run | manage_options | Ninguno |
zinn-reseller/get-settingszinn-reseller-get-settings | Lee los ajustes del kit de herramientas de distribuidor Devuelve los ajustes de este plugin (la dirección de la API, el plan que usan los nuevos pedidos, qué características están activadas). La clave de API nunca se devuelve, solo si hay una guardada. | Edición gratuita | GET …/abilities/zinn-reseller/get-settings/run | manage_options | Ninguno |
zinn-reseller/list-clientszinn-reseller-list-clients | Muestra tus clientes Muestra una lista de tus cuentas de cliente, página por página (cursor, limit). | Edición gratuita | GET …/abilities/zinn-reseller/list-clients/run | manage_options | cursor: string, limit: integer |
zinn-reseller/list-planszinn-reseller-list-plans | Lista los planes que puedes vender Muestra los planes de alojamiento y sus precios (product_line y currency lo limitan). | Edición gratuita | GET …/abilities/zinn-reseller/list-plans/run | manage_options | product_line: string, currency: string |
zinn-reseller/list-siteszinn-reseller-list-sites | Muestra los sitios de tus clientes Muestra una lista de todo lo que has aprovisionado para tus clientes (client_id y status lo filtran), una página a la vez. | Edición 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 | Asigna un plan a un cliente Asigna un cliente a uno de tus planes (client_id, plan_code; interval: month o year). Haz esto antes de su primer sitio. | Edición gratuita | POST …/abilities/zinn-reseller/set-client-plan/run | manage_options | client_id: string (obligatorio), plan_code: string (obligatorio), interval: month|year |
zinn-reseller/suspend-sitezinn-reseller-suspend-site | Suspender el sitio de un cliente Pone el sitio de un cliente en retención por falta de pago (site_id; reason: tu propia nota, nunca se muestra al cliente). El sitio deja de funcionar hasta que se levante la suspensión. | Edición gratuita | POST …/abilities/zinn-reseller/suspend-site/run | manage_options | site_id: string (obligatorio), reason: string |
zinn-reseller/unsuspend-sitezinn-reseller-unsuspend-site | Reactivar el sitio de un cliente Elimina la retención por falta de pago, para que el sitio vuelva a estar activo (site_id). | Edición gratuita | POST …/abilities/zinn-reseller/unsuspend-site/run | manage_options | site_id: string (obligatorio) |
zinn-reseller/update-settingszinn-reseller-update-settings | Cambia los ajustes de Reseller Toolkit Cambia los ajustes que envías (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce) y conserva el resto. La clave API y la dirección solo se modifican en la pantalla. | Edición gratuita | POST …/abilities/zinn-reseller/update-settings/run | manage_options | plan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean |