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

Zinn®, nuestro vikingo, vitorea mientras un asistente de IA se conecta a las herramientas de la plataforma.

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.

CapacidadQué haceEdiciónRESTOPermisoParámetros
zinn-reseller/create-client
zinn-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 gratuitaPOST …/abilities/zinn-reseller/create-client/runmanage_optionsname: string (obligatorio), default_currency: string
zinn-reseller/create-site
zinn-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 gratuitaPOST …/abilities/zinn-reseller/create-site/runmanage_optionsclient_id: string (obligatorio), product_line: string (obligatorio), primary_domain: string (obligatorio)
zinn-reseller/get-client-plan
zinn-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 gratuitaGET …/abilities/zinn-reseller/get-client-plan/runmanage_optionsclient_id: string (obligatorio)
zinn-reseller/get-overview
zinn-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 gratuitaGET …/abilities/zinn-reseller/get-overview/runmanage_optionsNinguno
zinn-reseller/get-settings
zinn-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 gratuitaGET …/abilities/zinn-reseller/get-settings/runmanage_optionsNinguno
zinn-reseller/list-clients
zinn-reseller-list-clients
Muestra tus clientes
Muestra una lista de tus cuentas de cliente, página por página (cursor, limit).
Edición gratuitaGET …/abilities/zinn-reseller/list-clients/runmanage_optionscursor: string, limit: integer
zinn-reseller/list-plans
zinn-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 gratuitaGET …/abilities/zinn-reseller/list-plans/runmanage_optionsproduct_line: string, currency: string
zinn-reseller/list-sites
zinn-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 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
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 gratuitaPOST …/abilities/zinn-reseller/set-client-plan/runmanage_optionsclient_id: string (obligatorio), plan_code: string (obligatorio), interval: month|year
zinn-reseller/suspend-site
zinn-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 gratuitaPOST …/abilities/zinn-reseller/suspend-site/runmanage_optionssite_id: string (obligatorio), reason: string
zinn-reseller/unsuspend-site
zinn-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 gratuitaPOST …/abilities/zinn-reseller/unsuspend-site/runmanage_optionssite_id: string (obligatorio)
zinn-reseller/update-settings
zinn-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 gratuitaPOST …/abilities/zinn-reseller/update-settings/runmanage_optionsplan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean