Développeurs

Référence des fonctionnalités de Zinn® Reseller Toolkit

Zinn® Reseller Toolkit enregistre ses actions auprès de l'API WordPress Abilities. Ces mêmes capacités sont des outils MCP sur le propre serveur du site et des routes REST sous /wp-json/wp-abilities/v1. Cette page est générée à partir du propre registre du plugin.

Guide de l'utilisateur : connecter une application d'IA

Points de terminaison

MCP sur HTTP (diffusible en continu)

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

MCP sur WP-CLI (entrée et sortie standard)

wp mcp-adapter serve --server=zinn-reseller --user=<login>

REST : lister les capacités

/wp-json/wp-abilities/v1/abilities?category=zinn-reseller

REST: exécuter une capacité

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

Authentification et autorisations

Les requêtes HTTP s'authentifient à l'aide d'un mot de passe d'application WordPress (HTTP Basic). La connexion au serveur MCP nécessite la capacité indiquée ci-dessous ; chaque fonctionnalité vérifie ensuite sa propre autorisation, par objet. Les fonctionnalités en lecture seule s'exécutent avec GET et leur entrée dans la chaîne de requête ; les autres avec POST et un corps JSON {"input": {…}}.

Exemples

# REST: exécuter une capacité
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":{}}}

Toutes les capacités

Généré à partir du fichier abilities.json du plugin, qui est lui-même généré à partir d'un site en cours d'exécution ; un test échoue lorsque les deux ne correspondent pas.

Capacité	Fonctionnement	Édition	Repos	Permission	Paramètres
`zinn-reseller/create-client` `zinn-reseller-create-client`	Créer un client Crée un compte client sous le vôtre (nom ; default_currency, un code à trois lettres). Attribuez-leur un forfait avant leur premier site.	Édition gratuite	`POST …/abilities/zinn-reseller/create-client/run`	manage_options	name: string (requis), default_currency: string
`zinn-reseller/create-site` `zinn-reseller-create-site`	Créer un site pour un client Crée un site hébergé pour l'un de vos clients (client_id, product_line, primary_domain). Il est facturé sur votre compte au forfait du client, comme depuis votre boutique.	Édition gratuite	`POST …/abilities/zinn-reseller/create-site/run`	manage_options	client_id: string (requis), product_line: string (requis), primary_domain: string (requis)
`zinn-reseller/get-client-plan` `zinn-reseller-get-client-plan`	Consulter le forfait d'un client Indique l'abonnement d'un client et son coût pour vous (client_id).	Édition gratuite	`GET …/abilities/zinn-reseller/get-client-plan/run`	manage_options	client_id: string (requis)
`zinn-reseller/get-overview` `zinn-reseller-get-overview`	Consulter votre compte revendeur Renvoie votre compte de revendeur en un seul coup d'œil : marque, forfaits, nombres de clients et de services, et éléments configurés.	Édition gratuite	`GET …/abilities/zinn-reseller/get-overview/run`	manage_options	Aucun
`zinn-reseller/get-settings` `zinn-reseller-get-settings`	Lire les paramètres de la boîte à outils du revendeur Renvoie les paramètres de ce plugin (l'adresse de l'API, le forfait utilisé pour les nouvelles commandes, les fonctionnalités activées). La clé d'API n'est jamais renvoyée, seule la présence ou non d'une clé enregistrée est indiquée.	Édition gratuite	`GET …/abilities/zinn-reseller/get-settings/run`	manage_options	Aucun
`zinn-reseller/list-clients` `zinn-reseller-list-clients`	Liste de vos clients Affiche vos comptes clients, une page à la fois (curseur, limite).	Édition gratuite	`GET …/abilities/zinn-reseller/list-clients/run`	manage_options	cursor: string, limit: integer
`zinn-reseller/list-plans` `zinn-reseller-list-plans`	Lister les forfaits que vous pouvez vendre Liste les plans d'hébergement et leurs prix (product_line et currency permettent de filtrer).	Édition gratuite	`GET …/abilities/zinn-reseller/list-plans/run`	manage_options	product_line: string, currency: string
`zinn-reseller/list-sites` `zinn-reseller-list-sites`	Lister les sites de vos clients Répertorie tout ce que vous avez provisionné pour vos clients (les paramètres client_id et status affinent la recherche), page par page.	Édition gratuite	`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`	Assigner un forfait à un client Associe un client à l'un de vos forfaits (client_id, plan_code ; interval : mois ou année). Effectuez cette opération avant la création de leur premier site.	Édition gratuite	`POST …/abilities/zinn-reseller/set-client-plan/run`	manage_options	client_id: string (requis), plan_code: string (requis), interval: month\|year
`zinn-reseller/suspend-site` `zinn-reseller-suspend-site`	Suspendre le site d'un client Place le site d'un client en suspension pour non-paiement (site_id ; motif : votre propre note, jamais affichée pour le client). Le site cesse d'être diffusé jusqu'à ce qu'il soit réactivé.	Édition gratuite	`POST …/abilities/zinn-reseller/suspend-site/run`	manage_options	site_id: string (requis), reason: string
`zinn-reseller/unsuspend-site` `zinn-reseller-unsuspend-site`	Activer le site d'un client Lève la suspension pour défaut de paiement, de sorte que le site soit à nouveau accessible (site_id).	Édition gratuite	`POST …/abilities/zinn-reseller/unsuspend-site/run`	manage_options	site_id: string (requis)
`zinn-reseller/update-settings` `zinn-reseller-update-settings`	Modifier les paramètres de la boîte à outils du revendeur Modifie les paramètres que vous envoyez (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce) et conserve les autres. La clé API et l'adresse sont modifiées uniquement à l'écran.	Édition gratuite	`POST …/abilities/zinn-reseller/update-settings/run`	manage_options	plan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean