Nhà phát triển

Tài liệu tham khảo tính năng của Zinn® Reseller Toolkit

Zinn® Reseller Toolkit đăng ký các hành động của mình với WordPress Abilities API. Các khả năng tương tự là các công cụ MCP trên máy chủ riêng của trang web và các tuyến REST dưới /wp-json/wp-abilities/v1. Trang này được tạo từ sổ đăng ký của chính plugin.

Hướng dẫn sử dụng: kết nối ứng dụng AI

Điểm cuối

MCP qua HTTP (có thể phát trực tuyến)

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

MCP qua WP-CLI (đầu vào và đầu ra chuẩn)

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

REST: liệt kê các khả năng

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

REST: chạy một kỹ năng

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

Xác thực và quyền truy cập

Các yêu cầu HTTP được xác thực bằng mật khẩu ứng dụng WordPress (HTTP Basic). Việc kết nối với máy chủ MCP cần có khả năng hiển thị bên dưới; mọi tính năng sau đó sẽ kiểm tra quyền riêng của chính nó, theo từng đối tượng. Các tính năng chỉ đọc chạy với phương thức GET và đầu vào nằm trong chuỗi truy vấn; các tính năng còn lại chạy với phương thức POST và phần thân JSON {"input": {…}}.

Ví dụ

# REST: chạy một kỹ năng
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":{}}}

Tất cả quyền hạn

Được tạo từ abilities.json của plugin, tệp này tự động được tạo từ một trang web đang chạy; một bài kiểm tra sẽ thất bại khi cả hai không khớp nhau.

Quyền hạn	Chức năng	Phiên bản	REST	Quyền hạn	Tham số
`zinn-reseller/create-client` `zinn-reseller-create-client`	Tạo khách hàng Tạo một tài khoản khách hàng dưới tài khoản của bạn (name; default_currency, mã gồm ba chữ ký tự). Đưa họ vào một gói dịch vụ trước trang web đầu tiên của họ.	Bản miễn phí	`POST …/abilities/zinn-reseller/create-client/run`	manage_options	name: string (Bắt buộc), default_currency: string
`zinn-reseller/create-site` `zinn-reseller-create-site`	Tạo trang web cho khách hàng Tạo một trang web được lưu trữ cho một trong các khách hàng của bạn (client_id, product_line, primary_domain). Dịch vụ này được tính phí vào tài khoản của bạn theo gói của khách hàng, từ cửa hàng của bạn.	Bản miễn phí	`POST …/abilities/zinn-reseller/create-site/run`	manage_options	client_id: string (Bắt buộc), product_line: string (Bắt buộc), primary_domain: string (Bắt buộc)
`zinn-reseller/get-client-plan` `zinn-reseller-get-client-plan`	Xem gói dịch vụ của khách hàng Trả về gói dịch vụ mà khách hàng đang sử dụng và chi phí cho bạn (client_id).	Bản miễn phí	`GET …/abilities/zinn-reseller/get-client-plan/run`	manage_options	client_id: string (Bắt buộc)
`zinn-reseller/get-overview` `zinn-reseller-get-overview`	Đọc tài khoản đại lý của bạn Cung cấp thông tin tổng quan về tài khoản đại lý của bạn trong một lần xem: thương hiệu, các gói dịch vụ, số lượng khách hàng và dịch vụ, cùng với các thiết lập hiện tại.	Bản miễn phí	`GET …/abilities/zinn-reseller/get-overview/run`	manage_options	không có
`zinn-reseller/get-settings` `zinn-reseller-get-settings`	Đọc các cài đặt Bộ công cụ Đại lý Trả về cài đặt của plugin này (địa chỉ API, gói cước mà đơn hàng mới sử dụng, các tính năng nào đang bật). Khóa API không bao giờ được trả về, chỉ cho biết có khóa nào được lưu hay không.	Bản miễn phí	`GET …/abilities/zinn-reseller/get-settings/run`	manage_options	không có
`zinn-reseller/list-clients` `zinn-reseller-list-clients`	Danh sách khách hàng Liệt kê các tài khoản khách hàng của bạn, mỗi lần một trang (con trỏ, giới hạn).	Bản miễn phí	`GET …/abilities/zinn-reseller/list-clients/run`	manage_options	cursor: string, limit: integer
`zinn-reseller/list-plans` `zinn-reseller-list-plans`	Liệt kê các gói bạn có thể bán Liệt kê các gói lưu trữ và giá của chúng (product_line và currency thu hẹp phạm vi).	Bản miễn phí	`GET …/abilities/zinn-reseller/list-plans/run`	manage_options	product_line: string, currency: string
`zinn-reseller/list-sites` `zinn-reseller-list-sites`	Liệt kê các trang web của khách hàng Liệt kê mọi thứ bạn đã cung cấp cho khách hàng của mình (client_id và status giúp thu hẹp phạm vi), từng trang một.	Bản miễn phí	`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`	Đặt một khách hàng vào gói dịch vụ Đưa một khách hàng vào một trong các gói dịch vụ của bạn (client_id, plan_code; interval: tháng hoặc năm). Hãy thực hiện việc này trước trang web đầu tiên của họ.	Bản miễn phí	`POST …/abilities/zinn-reseller/set-client-plan/run`	manage_options	client_id: string (Bắt buộc), plan_code: string (Bắt buộc), interval: month\|year
`zinn-reseller/suspend-site` `zinn-reseller-suspend-site`	Tạm ngưng trang web của khách hàng Tạm ngưng trang web của khách hàng do chưa thanh toán (site_id; lý do: ghi chú của riêng bạn, không bao giờ hiển thị cho khách hàng). Trang web ngừng hoạt động cho đến khi được bỏ tạm ngưng.	Bản miễn phí	`POST …/abilities/zinn-reseller/suspend-site/run`	manage_options	site_id: string (Bắt buộc), reason: string
`zinn-reseller/unsuspend-site` `zinn-reseller-unsuspend-site`	Khôi phục trang web của khách hàng Gỡ bỏ tạm ngưng do không thanh toán, để trang web hoạt động trở lại (site_id).	Bản miễn phí	`POST …/abilities/zinn-reseller/unsuspend-site/run`	manage_options	site_id: string (Bắt buộc)
`zinn-reseller/update-settings` `zinn-reseller-update-settings`	Thay đổi cài đặt Bộ công cụ Đại lý Thay đổi các cài đặt bạn gửi (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce) và giữ lại các cài đặt còn lại. Khóa API và địa chỉ chỉ được thay đổi trên màn hình.	Bản miễn phí	`POST …/abilities/zinn-reseller/update-settings/run`	manage_options	plan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean