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.

Guía del usuario: conectar una aplicación de IA

Endpoints

MCP sobre HTTP (transmisible)

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

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

REST: ejecutar una habilidad

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

Autenticació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-client` `zinn-reseller-create-client`	Crear un cliente Crea una cuenta de cliente bajo la suya (nombre; default_currency, un código de tres letras). Asígnele 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-site` `zinn-reseller-create-site`	Crear un sitio para un cliente Crea un sitio alojado para uno de sus clientes (client_id, product_line, primary_domain). Se factura a su cuenta según el plan del cliente, como desde su 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-plan` `zinn-reseller-get-client-plan`	Leer el plan de un cliente Devuelve el plan en el que se encuentra un cliente y lo que le cuesta (client_id).	Edición gratuita	`GET …/abilities/zinn-reseller/get-client-plan/run`	manage_options	client_id: string (obligatorio)
`zinn-reseller/get-overview` `zinn-reseller-get-overview`	Lea su cuenta de revendedor Devuelve su cuenta de revendedor de un solo vistazo: recuentos de marcas, planes, clientes y servicios, y lo que está configurado.	Edición gratuita	`GET …/abilities/zinn-reseller/get-overview/run`	manage_options	Ninguno
`zinn-reseller/get-settings` `zinn-reseller-get-settings`	Lea la configuración del Kit de herramientas de revendedor Devuelve la configuración de este plugin (la dirección de la API, el plan que utilizan 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-clients` `zinn-reseller-list-clients`	Listar sus clientes Lista las cuentas de sus clientes, una página a la vez (cursor, límite).	Edición gratuita	`GET …/abilities/zinn-reseller/list-clients/run`	manage_options	cursor: string, limit: integer
`zinn-reseller/list-plans` `zinn-reseller-list-plans`	Listar los planes que puede vender Muestra los planes de alojamiento y sus precios (product_line y currency los acotan).	Edición gratuita	`GET …/abilities/zinn-reseller/list-plans/run`	manage_options	product_line: string, currency: string
`zinn-reseller/list-sites` `zinn-reseller-list-sites`	Listar los sitios de sus clientes Muestra todo lo que ha aprovisionado para sus clientes (client_id y status acotan la búsqueda), página por página.	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-plan` `zinn-reseller-set-client-plan`	Asignar un plan a un cliente Asigna un cliente a uno de sus planes (client_id, plan_code; interval: mes o año). Haga 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-site` `zinn-reseller-suspend-site`	Suspender el sitio de un cliente Coloca el sitio de un cliente en suspensión por falta de pago (site_id; motivo: su propia nota, nunca se muestra al cliente). El sitio deja de funcionar hasta que se reactive.	Edición gratuita	`POST …/abilities/zinn-reseller/suspend-site/run`	manage_options	site_id: string (obligatorio), reason: string
`zinn-reseller/unsuspend-site` `zinn-reseller-unsuspend-site`	Reactivar el sitio de un cliente Quita 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-settings` `zinn-reseller-update-settings`	Modificar la configuración del Kit de herramientas de revendedor Modifica la configuración que envías (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce) y conserva el resto. La clave de API y la dirección se modifican únicamente 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