Vývojáři

Referat schopností pluginu Zinn® Reseller Toolkit

Zinn® Reseller Toolkit registruje své akce pomocí WordPress Abilities API. Stejné schopnosti jsou nástroji MCP na vlastním serveru webu a cestami REST pod /wp-json/wp-abilities/v1. Tato stránka je generována z vlastního registru pluginu.

Uživatelská příručka: připojení aplikace s umělou inteligencí

Zinn®, náš Viking, jásá, když se asistent s umělou inteligencí připojuje k nástrojům platformy.

Koncové body

MCP přes HTTP (streamovatelné)

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

MCP přes WP-CLI (standardní vstup a výstup)

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

REST: vypsat funkce

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

REST: spustit schopnost

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

Autentizace a oprávnění

HTTP požadavky se ověřují pomocí aplikačního hesla WordPress (HTTP Basic). Připojení k serveru MCP vyžaduje níže zobrazenou oprávněnost; každá schopnost pak kontroluje své vlastní oprávnění pro každý objekt. Schopnosti pouze pro čtení běží s metodou GET a vstupem v řetězci dotazu; ostatní s metodou POST a tělem JSON {„input“: {…}}.

Příklady

# REST: spustit schopnost
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":{}}}

Všechny oprávnění

Vygenerováno ze souboru abilities.json v pluginu, který se sám generuje z běžícího webu; test selže, pokud se tyto dva zdroje neshodují.

OprávněníCo to děláEdiceRESTOprávněníParametry
zinn-reseller/create-client
zinn-reseller-create-client
Vytvořit klienta
Vytvoří klientský účet pod vaším účtem (name; default_currency, třípísmenný kód). Před vytvořením jejich prvního webu jim přiřaďte tarif.
Bezplatná edicePOST …/abilities/zinn-reseller/create-client/runmanage_optionsname: string (povinné), default_currency: string
zinn-reseller/create-site
zinn-reseller-create-site
Vytvořte web pro klienta
Vytvoří hostovaný web pro jednoho z vašich klientů (client_id, product_line, primary_domain). Je účtován na váš účet podle tarifu klienta, stejně jako z vašeho obchodu.
Bezplatná edicePOST …/abilities/zinn-reseller/create-site/runmanage_optionsclient_id: string (povinné), product_line: string (povinné), primary_domain: string (povinné)
zinn-reseller/get-client-plan
zinn-reseller-get-client-plan
Přečtěte si plán klienta
Vrací, jaký tarif má klient sjednaný a kolik vás stojí (client_id).
Bezplatná ediceGET …/abilities/zinn-reseller/get-client-plan/runmanage_optionsclient_id: string (povinné)
zinn-reseller/get-overview
zinn-reseller-get-overview
Zobrazit prodejní účet
Vrátí váš účet prodejce v jednom čtení: značku, plány, počty klientů a služeb a informace o tom, co je nastaveno.
Bezplatná ediceGET …/abilities/zinn-reseller/get-overview/runmanage_optionsžádné
zinn-reseller/get-settings
zinn-reseller-get-settings
Přečtěte si nastavení sady Reseller Toolkit
Vrací nastavení tohoto pluginu (adresu API, tarif, který používají nové objednávky, které funkce jsou zapnuté). Klíč API se nikdy nevrací, pouze informace o tom, zda je nějaký uložen.
Bezplatná ediceGET …/abilities/zinn-reseller/get-settings/runmanage_optionsžádné
zinn-reseller/list-clients
zinn-reseller-list-clients
Uveďte své klienty
Vypíše vaše klientské účty, po jedné stránce (cursor, limit).
Bezplatná ediceGET …/abilities/zinn-reseller/list-clients/runmanage_optionscursor: string, limit: integer
zinn-reseller/list-plans
zinn-reseller-list-plans
Uveďte plány, které můžete prodávat
Zobrazí seznam hostingových plánů a jejich cen (product_line a currency jej zúží).
Bezplatná ediceGET …/abilities/zinn-reseller/list-plans/runmanage_optionsproduct_line: string, currency: string
zinn-reseller/list-sites
zinn-reseller-list-sites
Zobrazit weby vašich klientů
Vypisuje vše, co jste zřídili pro své klienty (client_id a status výsledek zužují), po jednotlivých stránkách.
Bezplatná ediceGET …/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
Přiřaďte klienta k tarifu
Přiřadí klienta k jednomu z vašich plánů (client_id, plan_code; interval: month nebo year). Proveďte to před jejich prvním webem.
Bezplatná edicePOST …/abilities/zinn-reseller/set-client-plan/runmanage_optionsclient_id: string (povinné), plan_code: string (povinné), interval: month|year
zinn-reseller/suspend-site
zinn-reseller-suspend-site
Pozastavit web klienta
Pozastaví web klienta z důvodu nezaplacení (site_id; reason: Vaše vlastní poznámka, která se klientovi nikdy nezobrazí). Web přestane fungovat, dokud nebude pozastavení zrušeno.
Bezplatná edicePOST …/abilities/zinn-reseller/suspend-site/runmanage_optionssite_id: string (povinné), reason: string
zinn-reseller/unsuspend-site
zinn-reseller-unsuspend-site
Obnovit web klienta
Zruší pozastavení z důvodu neplacení, takže web bude opět funkční (site_id).
Bezplatná edicePOST …/abilities/zinn-reseller/unsuspend-site/runmanage_optionssite_id: string (povinné)
zinn-reseller/update-settings
zinn-reseller-update-settings
Změnit nastavení Reseller Toolkit
Změní nastavení, která odešlete (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce), a zbývající zachová. Klíč API a adresa se mění pouze na obrazovce.
Bezplatná edicePOST …/abilities/zinn-reseller/update-settings/runmanage_optionsplan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean