开发者

Zinn® Reseller Toolkit 功能参考

Zinn® Reseller Toolkit 将其操作注册到 WordPress Abilities API。这些能力既是该网站自身服务器上的 MCP 工具,也是 /wp-json/wp-abilities/v1 下的 REST 路由。此页面由该插件自身的注册表生成。

用户指南:连接人工智能应用

我们的维京人 Zinn® 在 AI 助手连接到平台工具时欢呼。

服务端点

通过 HTTP 的 MCP(可流式传输)

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

通过 WP-CLI 的 MCP(标准输入和输出)

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

REST:列出功能

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

REST:运行能力

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

身份验证和权限

HTTP 请求使用 WordPress 应用程序密码(HTTP Basic)进行身份验证。连接到 MCP 服务器需要具备下方显示的权限;然后每个功能会根据每个对象检查其自身的权限。只读功能使用 GET 运行,其输入位于查询字符串中;其他功能使用 POST 和 JSON 主体 {"input": {…}} 运行。

示例

# REST:运行能力
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":{}}}

所有功能

由插件的 abilities.json 生成,该文件本身由运行中的站点生成;当两者不一致时测试将失败。

权限功能说明版本剩余权限参数
zinn-reseller/create-client
zinn-reseller-create-client
创建客户端
在您的账户下创建一个客户账户(name;default_currency,三位字母代码)。在他们创建第一个站点之前为其分配方案。
免费版POST …/abilities/zinn-reseller/create-client/runmanage_optionsname: string (必填), default_currency: string
zinn-reseller/create-site
zinn-reseller-create-site
为客户创建站点
为您的其中一位客户创建托管站点(client_id、product_line、primary_domain)。费用将按照该客户的方案计入您的账户,如同来自您的商店。
免费版POST …/abilities/zinn-reseller/create-site/runmanage_optionsclient_id: string (必填), product_line: string (必填), primary_domain: string (必填)
zinn-reseller/get-client-plan
zinn-reseller-get-client-plan
读取客户的方案
返回客户所在的方案及其对您的成本 (client_id)。
免费版GET …/abilities/zinn-reseller/get-client-plan/runmanage_optionsclient_id: string (必填)
zinn-reseller/get-overview
zinn-reseller-get-overview
读取您的分销商账户
单次读取即可返回您的分销商账户信息:品牌、方案、客户和服务的数量,以及已配置的内容。
免费版GET …/abilities/zinn-reseller/get-overview/runmanage_options无
zinn-reseller/get-settings
zinn-reseller-get-settings
读取分销商工具包设置
返回此插件的设置(API 地址、新订单使用的方案、启用了哪些功能)。API 密钥绝不会被返回,仅返回是否已保存。
免费版GET …/abilities/zinn-reseller/get-settings/runmanage_options无
zinn-reseller/list-clients
zinn-reseller-list-clients
列出您的客户
逐页列出您的客户账户(cursor,limit)。
免费版GET …/abilities/zinn-reseller/list-clients/runmanage_optionscursor: string, limit: integer
zinn-reseller/list-plans
zinn-reseller-list-plans
列出您可以销售的方案
列出主机方案及其价格(可通过 product_line 和 currency 缩小范围)。
免费版GET …/abilities/zinn-reseller/list-plans/runmanage_optionsproduct_line: string, currency: string
zinn-reseller/list-sites
zinn-reseller-list-sites
列出您客户的网站
逐页列出您为客户预配的所有内容(client_id 和 status 可缩小范围)。
免费版GET …/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
为客户分配套餐
将客户分配到您的某个方案中 (client_id, plan_code; interval: month 或 year)。请在其第一个站点之前执行此操作。
免费版POST …/abilities/zinn-reseller/set-client-plan/runmanage_optionsclient_id: string (必填), plan_code: string (必填), interval: month|year
zinn-reseller/suspend-site
zinn-reseller-suspend-site
暂停客户网站
将客户的站点置于未付款暂停状态(site_id;原因:您自己的备注,绝不会向客户显示)。该站点将停止提供服务,直到解除暂停。
免费版POST …/abilities/zinn-reseller/suspend-site/runmanage_optionssite_id: string (必填), reason: string
zinn-reseller/unsuspend-site
zinn-reseller-unsuspend-site
取消暂停客户的网站
解除未付款冻结,以便站点恢复正常访问 (site_id)。
免费版POST …/abilities/zinn-reseller/unsuspend-site/runmanage_optionssite_id: string (必填)
zinn-reseller/update-settings
zinn-reseller-update-settings
更改 Reseller Toolkit 设置
更改您发送的设置(plan_code、enable_domain_search、enable_panel_link、enable_woocommerce)并保留其余设置。API 密钥和地址仅在屏幕上更改。
免费版POST …/abilities/zinn-reseller/update-settings/runmanage_optionsplan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean