Entwickler

Zinn® Reseller Toolkit-Funktionen-Referenz

Zinn® Reseller Toolkit registriert seine Aktionen bei der WordPress Abilities API. Dieselben Berechtigungen sind MCP-Tools auf dem eigenen Server der Website und REST-Routen unter /wp-json/wp-abilities/v1. Diese Seite wird aus der eigenen Registry des Plugins generiert.

Benutzerhandbuch: Verbinden einer KI-App

Endpunkte

MCP über HTTP (streamable)

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

MCP über WP-CLI (Standardeingabe und -ausgabe)

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

REST: Fähigkeiten auflisten

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

REST: Fähigkeit ausführen

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

Authentifizierung und Berechtigungen

HTTP-Anfragen authentifizieren sich mit einem WordPress-Anwendungspasswort (HTTP Basic). Das Verbinden mit dem MCP-Server erfordert die unten gezeigte Berechtigung; jede Funktion prüft anschließend ihre eigene Berechtigung pro Objekt. Schreibgeschützte Funktionen werden mit GET und ihrer Eingabe in der Abfragezeichenfolge ausgeführt; die anderen mit POST und einem JSON-Body {"input": {…}}.

Beispiele

# REST: Fähigkeit ausführen
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":{}}}

Alle Berechtigungen

Generiert aus der abilities.json des Plugins, die ihrerseits aus einer laufenden Website generiert wird; ein Test schlägt fehl, wenn beide nicht übereinstimmen.

BerechtigungFunktionsweiseAusgabeRuhezeitBerechtigungParameter
zinn-reseller/create-client
zinn-reseller-create-client
Kunden anlegen
Erstellt ein Kundenkonto unter Ihrem (Name; default_currency, ein dreibuchstabiger Code). Weisen Sie ihnen vor ihrer ersten Website einen Tarif zu.
Kostenlose EditionPOST …/abilities/zinn-reseller/create-client/runmanage_optionsname: string (Erforderlich), default_currency: string
zinn-reseller/create-site
zinn-reseller-create-site
Erstellen Sie eine Website für einen Kunden
Erstellt eine gehostete Website für einen Ihrer Kunden (client_id, product_line, primary_domain). Die Abrechnung erfolgt über Ihr Konto zum Kundentarif über Ihren Shop.
Kostenlose EditionPOST …/abilities/zinn-reseller/create-site/runmanage_optionsclient_id: string (Erforderlich), product_line: string (Erforderlich), primary_domain: string (Erforderlich)
zinn-reseller/get-client-plan
zinn-reseller-get-client-plan
Tarif eines Kunden anzeigen
Gibt zurück, welchen Tarif ein Kunde hat und was er Sie kostet (client_id).
Kostenlose EditionGET …/abilities/zinn-reseller/get-client-plan/runmanage_optionsclient_id: string (Erforderlich)
zinn-reseller/get-overview
zinn-reseller-get-overview
Reseller-Konto lesen
Gibt Ihr Reseller-Konto auf einen Blick wieder: Marke, Tarife, Anzahl der Kunden und Dienste sowie die vorgenommenen Einstellungen.
Kostenlose EditionGET …/abilities/zinn-reseller/get-overview/runmanage_optionsKeine
zinn-reseller/get-settings
zinn-reseller-get-settings
Lesen Sie die Einstellungen des Reseller-Toolkits
Gibt die Einstellungen dieses Plugins zurück (die API-Adresse, den Tarif für neue Bestellungen, welche Funktionen aktiviert sind). Der API-Schlüssel wird niemals zurückgegeben, sondern nur, ob einer gespeichert ist.
Kostenlose EditionGET …/abilities/zinn-reseller/get-settings/runmanage_optionsKeine
zinn-reseller/list-clients
zinn-reseller-list-clients
Ihre Kunden auflisten
Listet Ihre Kundenkonten auf, jeweils eine Seite (Cursor, Limit).
Kostenlose EditionGET …/abilities/zinn-reseller/list-clients/runmanage_optionscursor: string, limit: integer
zinn-reseller/list-plans
zinn-reseller-list-plans
Listen Sie die Tarife auf, die Sie verkaufen können
Listet die Hosting-Tarife und deren Preise auf (product_line und currency grenzen dies ein).
Kostenlose EditionGET …/abilities/zinn-reseller/list-plans/runmanage_optionsproduct_line: string, currency: string
zinn-reseller/list-sites
zinn-reseller-list-sites
Websites Ihrer Kunden auflisten
Listet alles auf, was Sie für Ihre Kunden bereitgestellt haben (client_id und status grenzen die Suche ein), Seite für Seite.
Kostenlose EditionGET …/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
Einen Kunden einem Tarif zuordnen
Weist einen Kunden einem Ihrer Tarife zu (client_id, plan_code; Intervall: Monat oder Jahr). Führen Sie dies vor dessen erster Website aus.
Kostenlose EditionPOST …/abilities/zinn-reseller/set-client-plan/runmanage_optionsclient_id: string (Erforderlich), plan_code: string (Erforderlich), interval: month|year
zinn-reseller/suspend-site
zinn-reseller-suspend-site
Kundensite sperren
Setzt die Website eines Kunden aufgrund ausbleibender Zahlung in den Status „Nichtzahlung“ (site_id; Grund: Ihre eigene Notiz, wird dem Kunden niemals angezeigt). Die Website wird so lange nicht mehr ausgelöst, bis sie wieder entsperrt wird.
Kostenlose EditionPOST …/abilities/zinn-reseller/suspend-site/runmanage_optionssite_id: string (Erforderlich), reason: string
zinn-reseller/unsuspend-site
zinn-reseller-unsuspend-site
Die Website eines Kunden reaktivieren
Hebt eine Zahlungssperre auf, sodass die Website wieder erreichbar ist (site_id).
Kostenlose EditionPOST …/abilities/zinn-reseller/unsuspend-site/runmanage_optionssite_id: string (Erforderlich)
zinn-reseller/update-settings
zinn-reseller-update-settings
Einstellungen für das Reseller-Toolkit ändern
Ändert die von Ihnen gesendeten Einstellungen (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce) und behält den Rest bei. Der API-Schlüssel und die Adresse werden nur auf dem Bildschirm geändert.
Kostenlose EditionPOST …/abilities/zinn-reseller/update-settings/runmanage_optionsplan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean