Geliştiriciler

Zinn® Reseller Toolkit yetenekleri başvurusu

Zinn® Reseller Toolkit, eylemlerini WordPress Abilities API'ye kaydeder. Aynı yetenekler, sitenin kendi sunucusunda MCP araçları ve /wp-json/wp-abilities/v1 altında REST rotalarıdır. Bu sayfa, eklentinin kendi kayıt defterinden oluşturulmuştur.

Kullanıcı kılavuzu: bir yapay zeka uygulaması bağlama

Bir yapay zekâ asistanı platformun araçlarına bağlanırken Vikingimiz Zinn® tezahürat yapıyor.

Uç Noktalar

HTTP üzerinden MCP (akışlı)

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

WP-CLI üzerinden MCP (standart girdi ve çıktı)

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

REST: yetenekleri listele

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

REST: bir yeteneği çalıştır

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

Kimlik doğrulama ve izinler

HTTP istekleri bir WordPress uygulama parolası (HTTP Basic) ile kimlik doğrulaması yapar. MCP sunucusuna bağlanmak aşağıda gösterilen yeteneği gerektirir; her yetki daha sonra her nesne için kendi iznini kontrol eder. Salt okunur yetenekler GET ile ve girdileri sorgu dizesinde çalışır; diğerleri ise POST ve JSON gövdesi {"input": {…}} ile çalışır.

Örnekler

# REST: bir yeteneği çalıştır
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üm yetenekler

Çalışan bir siteden otomatik olarak üretilen eklentinin abilities.json dosyasından oluşturulmuştur; ikisi uyuşmadığında bir test başarısız olur.

YetenekNe işe yararSürümDinlendirİzinParametreler
zinn-reseller/create-client
zinn-reseller-create-client
İstemci oluşturun
Hesabınızın altında bir müşteri hesabı oluşturur (name; default_currency, üç harfli bir kod). İlk sitelerinden önce onları bir plana dahil edin.
Ücretsiz sürümPOST …/abilities/zinn-reseller/create-client/runmanage_optionsname: string (zorunlu), default_currency: string
zinn-reseller/create-site
zinn-reseller-create-site
Bir müşteri için site oluşturun
Müşterilerinizden biri için barındırılan bir site oluşturur (client_id, product_line, primary_domain). Mağazanızdan yapılmış gibi, müşterinin planına göre hesabınıza faturalandırılır.
Ücretsiz sürümPOST …/abilities/zinn-reseller/create-site/runmanage_optionsclient_id: string (zorunlu), product_line: string (zorunlu), primary_domain: string (zorunlu)
zinn-reseller/get-client-plan
zinn-reseller-get-client-plan
Bir müşterinin planını okuyun
Bir müşterinin hangi planda olduğunu ve bunun size maliyetini döndürür (client_id).
Ücretsiz sürümGET …/abilities/zinn-reseller/get-client-plan/runmanage_optionsclient_id: string (zorunlu)
zinn-reseller/get-overview
zinn-reseller-get-overview
Bayi hesabınızı okuyun
Bayi hesabınızı tek bir okumada döndürür: marka, planlar, müşteri ve hizmet sayıları ve nelerin ayarlandığı.
Ücretsiz sürümGET …/abilities/zinn-reseller/get-overview/runmanage_optionshiçbiri
zinn-reseller/get-settings
zinn-reseller-get-settings
Bayi Araç Seti ayarlarını okuyun
Bu eklentinin ayarlarını döndürür (API adresi, yeni siparişlerin kullandığı plan, hangi özelliklerin açık olduğu). API anahtarı hiçbir zaman döndürülmez, yalnızca bir anahtarın kayıtlı olup olmadığı döndürülür.
Ücretsiz sürümGET …/abilities/zinn-reseller/get-settings/runmanage_optionshiçbiri
zinn-reseller/list-clients
zinn-reseller-list-clients
Müşterilerinizi listeleyin
Müşteri hesaplarınızı her seferinde bir sayfa olarak listeler (cursor, limit).
Ücretsiz sürümGET …/abilities/zinn-reseller/list-clients/runmanage_optionscursor: string, limit: integer
zinn-reseller/list-plans
zinn-reseller-list-plans
Satabileceğiniz planları listeleyin
Barındırma planlarını ve fiyatlarını listeler (product_line ve currency bunu daraltır).
Ücretsiz sürümGET …/abilities/zinn-reseller/list-plans/runmanage_optionsproduct_line: string, currency: string
zinn-reseller/list-sites
zinn-reseller-list-sites
Müşterilerinizin sitelerini listeleyin
Müşterileriniz için sağladığınız her şeyi (client_id ve status bunu daraltır) sayfa sayfa listeler.
Ücretsiz sürümGET …/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
Bir müşteriyi plana atayın
Bir müşteriyi planlarınızdan birine atar (client_id, plan_code; interval: month veya year). Bunu ilk sitelerinden önce yapın.
Ücretsiz sürümPOST …/abilities/zinn-reseller/set-client-plan/runmanage_optionsclient_id: string (zorunlu), plan_code: string (zorunlu), interval: month|year
zinn-reseller/suspend-site
zinn-reseller-suspend-site
Müşterinin sitesini askıya alın
Bir müşterinin sitesini ödeme yapılmaması nedeniyle beklemeye alır (site_id; reason: kendi notunuz, müşteriye asla gösterilmez). Askıya alma işlemi kaldırılana kadar site hizmet vermeyi durdurur.
Ücretsiz sürümPOST …/abilities/zinn-reseller/suspend-site/runmanage_optionssite_id: string (zorunlu), reason: string
zinn-reseller/unsuspend-site
zinn-reseller-unsuspend-site
Bir müşterinin sitesinin askısını kaldırın
Ödeme yapılmaması sebebiyle uygulanan askıya almayı kaldırır, böylece site yeniden hizmet vermeye başlar (site_id).
Ücretsiz sürümPOST …/abilities/zinn-reseller/unsuspend-site/runmanage_optionssite_id: string (zorunlu)
zinn-reseller/update-settings
zinn-reseller-update-settings
Reseller Toolkit ayarlarını değiştirin
Gönderdiğiniz ayarları (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce) değiştirir ve geri kalanları korur. API anahtarı ve adres yalnızca ekranda değiştirilir.
Ücretsiz sürümPOST …/abilities/zinn-reseller/update-settings/runmanage_optionsplan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean