Fejlesztők

Zinn® Reseller Toolkit képességreferencia

A Zinn® Reseller Toolkit regisztrálja műveleteit a WordPress Abilities API-val. Ugyanezek a képességek MCP-eszközök a webhely saját szerverén és REST-útvonalak a /wp-json/wp-abilities/v1 alatt. Ez az oldal a bővítmény saját regiszteréből generálódik.

Felhasználói útmutató: AI-alkalmazás csatlakoztatása

Végpontok

MCP HTTP-n keresztül (streamelhető)

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

MCP a WP-CLI-n keresztül (szabványos bemenet és kimenet)

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

REST: képességek listázása

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

REST: képesség futtatása

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

Hitelesítés és jogosultságok

A HTTP-kérések egy WordPress alkalmazásjelszóval (HTTP Basic) hitelesítik magukat. Az MCP-szerverhez való csatlakozáshoz az alábbi jogosultság szükséges; ezután minden egyes képesség objektumunkként ellenőrzi a saját engedélyét. Az írásvédett képességek GET metódussal futnak, bemenetük a lekérdezési sztringben szerepel; a többi POST metódussal és egy JSON törzzsel ({"input": {…}}).

Példák

# REST: képesség futtatása
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":{}}}

Minden képesség

A bővítmény abilities.json fájlából generálva, amely maga is egy futó webhelyből készül; egy teszt sikertelen, ha a kettő eltér egymástól.

Jogosultság	Mit csinál	Kiadás	REST	Jogosultság	Paraméterek
`zinn-reseller/create-client` `zinn-reseller-create-client`	Ügyfél létrehozása Ügyfélfiókot hoz létre az Öné alatt (name; default_currency, egy hárombetűs kód). Tegye őket egy csomagra az első webhelyük előtt.	Ingyenes kiadás	`POST …/abilities/zinn-reseller/create-client/run`	manage_options	name: string (kötelező), default_currency: string
`zinn-reseller/create-site` `zinn-reseller-create-site`	Webhely létrehozása ügyfél részére Létrehoz egy tárolt webhelyet az egyik ügyfele számára (client_id, product_line, primary_domain). A számlázás az Ön fiókjára történik az ügyfél csomagja szerint, az Ön áruházából indítva.	Ingyenes kiadás	`POST …/abilities/zinn-reseller/create-site/run`	manage_options	client_id: string (kötelező), product_line: string (kötelező), primary_domain: string (kötelező)
`zinn-reseller/get-client-plan` `zinn-reseller-get-client-plan`	Ügyfél csomagjának megtekintése Visszaadja, hogy egy ügyfél melyik csomagban van, és hogy az mennyibe kerül önnek (client_id).	Ingyenes kiadás	`GET …/abilities/zinn-reseller/get-client-plan/run`	manage_options	client_id: string (kötelező)
`zinn-reseller/get-overview` `zinn-reseller-get-overview`	Olvassa el a viszonteladói fiókját Egyetlen olvasásra visszaadja a viszonteladói fiókját: a márkát, a csomagokat, az ügyfelek és a szolgáltatások számát, valamint a beállított elemeket.	Ingyenes kiadás	`GET …/abilities/zinn-reseller/get-overview/run`	manage_options	nincs
`zinn-reseller/get-settings` `zinn-reseller-get-settings`	Olvassa el a Viszonteladói Eszközkészlet beállításait Visszaadja ezen bővítmény beállításait (az API-címet, az új megrendelések által használt csomagot, valamint a bekapcsolt funkciókat). Az API-kulcsot soha nem adja vissza, csak azt, hogy van-e elmentve.	Ingyenes kiadás	`GET …/abilities/zinn-reseller/get-settings/run`	manage_options	nincs
`zinn-reseller/list-clients` `zinn-reseller-list-clients`	Ügyfelek listázása Kilistázza az ügyfélszámláit oldalanként (kurzor, limit).	Ingyenes kiadás	`GET …/abilities/zinn-reseller/list-clients/run`	manage_options	cursor: string, limit: integer
`zinn-reseller/list-plans` `zinn-reseller-list-plans`	Sorolja fel az eladható csomagokat Felsorolja a tárhelycsomagokat és áraikat (a product_line és a currency szűkíti a kört).	Ingyenes kiadás	`GET …/abilities/zinn-reseller/list-plans/run`	manage_options	product_line: string, currency: string
`zinn-reseller/list-sites` `zinn-reseller-list-sites`	Ügyfelei webhelyeinek listázása Felsorolja az ügyfelek számára kiépített összes elemet (a client_id és a status szűkíti a kört), oldalanként.	Ingyenes kiadás	`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`	Ügyfél áthelyezése csomagra Egy csomagra helyez egy ügyfelet (client_id, plan_code; interval: month vagy year). Tedd ezt meg az első webhelye előtt.	Ingyenes kiadás	`POST …/abilities/zinn-reseller/set-client-plan/run`	manage_options	client_id: string (kötelező), plan_code: string (kötelező), interval: month\|year
`zinn-reseller/suspend-site` `zinn-reseller-suspend-site`	Ügyfél webhelyének felfüggesztése Felfüggeszti egy ügyfél webhelyét nemfizetés miatt (site_id; ok: a saját jegyzete, amely soha nem jelenik meg az ügyfél számára). A webhely a visszaállításig nem szolgál ki látogatókat.	Ingyenes kiadás	`POST …/abilities/zinn-reseller/suspend-site/run`	manage_options	site_id: string (kötelező), reason: string
`zinn-reseller/unsuspend-site` `zinn-reseller-unsuspend-site`	Ügyfél webhelyének felfüggesztésének megszüntetése Feloldja a nem fizetés miatti zárolást, így az oldal ismét elérhetővé válik (site_id).	Ingyenes kiadás	`POST …/abilities/zinn-reseller/unsuspend-site/run`	manage_options	site_id: string (kötelező)
`zinn-reseller/update-settings` `zinn-reseller-update-settings`	A Viszonteladói Eszközkészlet beállításainak módosítása Megváltoztatja a elküldött beállításokat (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce), a többit pedig megőrzi. Az API-kulcs és a cím csak a képernyőn módosul.	Ingyenes kiadás	`POST …/abilities/zinn-reseller/update-settings/run`	manage_options	plan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean