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

Zinn®, người Viking của chúng tôi, đang reo hò khi trợ lý AI kết nối với các công cụ của nền tảng.

Đ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ạnChức năngPhiên bảnRESTQuyềnTham số
zinn-reseller/create-client
zinn-reseller-create-client
Tạo máy khách
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ữ cái). Hãy chỉ định gói cho họ trước khi tạo trang web đầu tiên.
Bản miễn phíPOST …/abilities/zinn-reseller/create-client/runmanage_optionsname: string (Bắt buộc), default_currency: string
zinn-reseller/create-site
zinn-reseller-create-site
Tạo một trang web cho khách hàng
Tạo một trang web được lưu trữ cho một trong những khách hàng của bạn (client_id, product_line, primary_domain). Phí được tính vào tài khoản của bạn theo gói của khách hàng, như từ cửa hàng của bạn.
Bản miễn phíPOST …/abilities/zinn-reseller/create-site/runmanage_optionsclient_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
Đọc gói 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í mà bạn phải chịu (client_id).
Bản miễn phíGET …/abilities/zinn-reseller/get-client-plan/runmanage_optionsclient_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
Trả về tài khoản đại lý của bạn trong một lần đọc: thương hiệu, các gói, số lượng khách hàng và dịch vụ, cùng những gì đã được thiết lập.
Bản miễn phíGET …/abilities/zinn-reseller/get-overview/runmanage_optionskhông có
zinn-reseller/get-settings
zinn-reseller-get-settings
Đọc cài đặt Reseller Toolkit
Trả về cài đặt của plugin này (địa chỉ API, gói mà các đơn hàng mới sử dụng, các tính năng nào đang được bật). Khóa API không bao giờ được trả về, chỉ cho biết liệu đã có khóa được lưu hay chưa.
Bản miễn phíGET …/abilities/zinn-reseller/get-settings/runmanage_optionskhông có
zinn-reseller/list-clients
zinn-reseller-list-clients
Liệt kê khách hàng của bạn
Liệt kê các tài khoản khách hàng của bạn, mỗi lần một trang (cursor, limit).
Bản miễn phíGET …/abilities/zinn-reseller/list-clients/runmanage_optionscursor: 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 dùng để thu hẹp phạm vi).
Bản miễn phíGET …/abilities/zinn-reseller/list-plans/runmanage_optionsproduct_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 của bạn
Liệt kê mọi thứ bạn đã cấp phép cho khách hàng của mình (client_id và status giúp thu hẹp phạm vi), mỗi lần một trang.
Bản miễn phí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
Gán gói cho khách hàng
Gán một khách hàng vào một trong các gói của bạn (client_id, plan_code; interval: month hoặc year). 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/runmanage_optionsclient_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
Đưa trang web của khách hàng vào trạng thái tạm ngưng do chưa thanh toán (site_id; lý do: ghi chú riêng của bạn, không bao giờ hiển thị cho khách hàng). Trang web sẽ ngừng hoạt động cho đến khi được mở lại.
Bản miễn phíPOST …/abilities/zinn-reseller/suspend-site/runmanage_optionssite_id: string (Bắt buộc), reason: string
zinn-reseller/unsuspend-site
zinn-reseller-unsuspend-site
Bỏ tạm ngưng trang web của khách hàng
Gỡ bỏ lệnh tạm ngưng do chưa thanh toán, để trang web hoạt động trở lại (site_id).
Bản miễn phíPOST …/abilities/zinn-reseller/unsuspend-site/runmanage_optionssite_id: string (Bắt buộc)
zinn-reseller/update-settings
zinn-reseller-update-settings
Thay đổi cài đặt Reseller Toolkit
Thay đổi các cài đặt bạn gửi (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce) và giữ nguyên 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/runmanage_optionsplan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean