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

Zinn®, notre Viking, exulte pendant qu'un assistant IA se connecte aux outils de la plateforme.

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éSon rôleÉditionReposAutorisationParamètres
zinn-reseller/create-client
zinn-reseller-create-client
Créer un client
Crée un compte client sous le vôtre (name ; default_currency, un code à trois lettres). Associez-les à une offre avant leur premier site.
Édition gratuitePOST …/abilities/zinn-reseller/create-client/runmanage_optionsname: 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 selon le forfait du client, comme depuis votre boutique.
Édition gratuitePOST …/abilities/zinn-reseller/create-site/runmanage_optionsclient_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
Renvoie le plan auquel un client a souscrit et ce qu’il vous coûte (client_id).
Édition gratuiteGET …/abilities/zinn-reseller/get-client-plan/runmanage_optionsclient_id: string (requis)
zinn-reseller/get-overview
zinn-reseller-get-overview
Consulter votre compte revendeur
Renvoie votre compte revendeur en une seule lecture : marque, forfaits, nombre de clients et de services, et ce qui est configuré.
Édition gratuiteGET …/abilities/zinn-reseller/get-overview/runmanage_optionsAucun
zinn-reseller/get-settings
zinn-reseller-get-settings
Lire les réglages du Reseller Toolkit
Renvoie les réglages de cette extension (l’adresse de l’API, l’abonnement utilisé par les nouvelles commandes, les fonctionnalités activées). La clé d’API n’est jamais renvoyée, seulement l’information indiquant si une clé est enregistrée.
Édition gratuiteGET …/abilities/zinn-reseller/get-settings/runmanage_optionsAucun
zinn-reseller/list-clients
zinn-reseller-list-clients
Lister vos clients
Répertorie vos comptes clients, une page à la fois (cursor, limit).
Édition gratuiteGET …/abilities/zinn-reseller/list-clients/runmanage_optionscursor: string, limit: integer
zinn-reseller/list-plans
zinn-reseller-list-plans
Listez les plans que vous pouvez vendre
Répertorie les offres d’hébergement et leurs tarifs (product_line et currency réduisent la sélection).
Édition gratuiteGET …/abilities/zinn-reseller/list-plans/runmanage_optionsproduct_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 (client_id et status permettent de restreindre la recherche), page par page.
Édition gratuiteGET …/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
Attribuer un forfait à un client
Associe un client à l’un de vos forfaits (client_id, plan_code ; interval : month ou year). Effectuez cette opération avant son premier site.
Édition gratuitePOST …/abilities/zinn-reseller/set-client-plan/runmanage_optionsclient_id: string (requis), plan_code: string (requis), interval: month|year
zinn-reseller/suspend-site
zinn-reseller-suspend-site
Suspendre le site d’un client
Met le site d’un client en suspension pour défaut de paiement (site_id ; reason : votre propre note, jamais affichée au client). Le site cesse de fonctionner jusqu’à ce que sa suspension soit levée.
Édition gratuitePOST …/abilities/zinn-reseller/suspend-site/runmanage_optionssite_id: string (requis), reason: string
zinn-reseller/unsuspend-site
zinn-reseller-unsuspend-site
Réactiver le site d’un client
Lève une suspension pour non-paiement afin que le site fonctionne à nouveau (site_id).
Édition gratuitePOST …/abilities/zinn-reseller/unsuspend-site/runmanage_optionssite_id: string (requis)
zinn-reseller/update-settings
zinn-reseller-update-settings
Modifier les réglages de Reseller Toolkit
Modifie les réglages que vous envoyez (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce) et conserve les autres. La clé API et l’adresse ne sont modifiées qu’à l’écran.
Édition gratuitePOST …/abilities/zinn-reseller/update-settings/runmanage_optionsplan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean