ڈویلپرز

Zinn® Reseller Toolkit کی صلاحیتوں کا حوالہ

Zinn® Reseller Toolkit اپنے ایکشنز کو WordPress Abilities API کے ساتھ رجسٹر کرتا ہے۔ یہی abilities سائٹ کے اپنے سرور پر MCP ٹولز اور /wp-json/wp-abilities/v1 کے تحت REST روٹس ہیں۔ یہ صفحہ پلگ ان کی اپنی رجسٹری سے تیار کیا گیا ہے۔

صارف گائیڈ: ایک AI ایپ مربوط کریں

⁦Zinn®⁩، ہمارا وائکنگ، نعرہ لگا رہا ہے جب کہ ایک AI اسسٹنٹ پلیٹ فارم کے ٹولز سے منسلک ہوتا ہے۔

اینڈ پوائنٹس

MCP بذریعہ HTTP (اسٹریمیبل)

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

WP-CLI پر MCP (معیاری ان پٹ اور آؤٹ پٹ)

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

REST: صلاحیتوں کی فہرست بنائیں

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

REST: ایک قابلیت چلائیں

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

تصدیق اور اجازتیں

ایچ ٹی ٹی پی (HTTP) درخواستیں ایک WordPress ایپلیکیشن پاس ورڈ (ایچ ٹی ٹی پی بیسک) کے ساتھ توثیق کرتی ہیں۔ ایم سی پی (MCP) سرور سے جڑنے کے لیے نیچے دکھائی گئی صلاحیت کی ضرورت ہوتی ہے؛ اس کے بعد ہر صلاحیت ہر آبجیکٹ کے لحاظ سے اپنی اجازت کی جانچ کرتی ہے۔ صرف پڑھنے کی صلاحیتیں GET کے ساتھ اور ان کا ان پٹ کوئیری اسٹرنگ میں چلتی ہیں؛ دیگر POST اور ایک JSON باڈی {"input": {…}} کے ساتھ۔

مثالیں

# REST: ایک قابلیت چلائیں
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":{}}}

تمام صلاحیتیں

یہ پلگ ان کی abilities.json سے تیار کیا گیا ہے، جو خود ایک فعال سائٹ سے تیار ہوتی ہے؛ جب دونوں میں اختلاف ہوتا ہے تو ٹیسٹ ناكام ہو جاتا ہے۔

صلاحیتیہ کیا کرتا ہےایڈیشنRESTاجازتپیرامیٹرز
zinn-reseller/create-client
zinn-reseller-create-client
کلائنٹ بنائیں
آپ کے اکاؤنٹ کے ماتحت ایک کلائنٹ اکاؤنٹ بناتا ہے (name؛ default_currency، تین حرفی کوڈ)۔ ان کی پہلی سائٹ سے پہلے انہیں کسی پلان میں شامل کریں۔
مفت ایڈیشنPOST …/abilities/zinn-reseller/create-client/runmanage_optionsname: string (لازمی), default_currency: string
zinn-reseller/create-site
zinn-reseller-create-site
کسی کلائنٹ کے لیے ایک سائٹ بنائیں
آپ کے گاہکوں میں سے ایک کے لیے ہوسٹ کردہ سائٹ بناتا ہے (client_id, product_line, primary_domain)۔ اس کا بل آپ کے اکاؤنٹ پر گاہک کے پلان کے مطابق بھیجا جاتا ہے، جیسے آپ کی دکان سے ہو۔
مفت ایڈیشنPOST …/abilities/zinn-reseller/create-site/runmanage_optionsclient_id: string (لازمی), product_line: string (لازمی), primary_domain: string (لازمی)
zinn-reseller/get-client-plan
zinn-reseller-get-client-plan
کلائنٹ کا پلان پڑھیں
یہ بتاتا ہے کہ کوئی کلائنٹ کس پلان پر ہے اور اس پر آپ کی کیا لاگت آتی ہے (client_id)۔
مفت ایڈیشنGET …/abilities/zinn-reseller/get-client-plan/runmanage_optionsclient_id: string (لازمی)
zinn-reseller/get-overview
zinn-reseller-get-overview
اپنا ری سیلر اکاؤنٹ پڑھیں
ایک ہی پڑھنے میں آپ کا ری سیلر اکاؤنٹ واپس کرتا ہے: برانڈ، منصوبے، کلائنٹس اور خدمات کی تعداد، اور جو سیٹ اپ کیا گیا ہے۔
مفت ایڈیشنGET …/abilities/zinn-reseller/get-overview/runmanage_optionsکوئی نہیں
zinn-reseller/get-settings
zinn-reseller-get-settings
ری سیلر ٹول کٹ (Reseller Toolkit) کی ترتیبات پڑھیں
اس پلگ ان کی ترتیبات واپس کرتا ہے (API کا پتہ، وہ منصوبہ جو نئے آرڈرز استعمال کرتے ہیں، کون سے فیچرز فعال ہیں)۔ API کی کبھی واپس نہیں کی جاتی، صرف یہ بتایا جاتا ہے کہ آیا کوئی محفوظ ہے یا نہیں۔
مفت ایڈیشنGET …/abilities/zinn-reseller/get-settings/runmanage_optionsکوئی نہیں
zinn-reseller/list-clients
zinn-reseller-list-clients
اپنے کلائنٹس کی فہرست بنائیں
ایک وقت میں ایک صفحہ آپ کے کلائنٹ اکاؤنٹس کی فہرست بناتا ہے (cursor، limit)۔
مفت ایڈیشنGET …/abilities/zinn-reseller/list-clients/runmanage_optionscursor: string, limit: integer
zinn-reseller/list-plans
zinn-reseller-list-plans
ان منصوبوں کی فہرست بنائیں جو آپ فروخت کر سکتے ہیں
ہوسٹنگ کے منصوبوں اور ان کی قیمتوں کی فہرست بناتا ہے (product_line اور currency اسے محدود کرتے ہیں)۔
مفت ایڈیشنGET …/abilities/zinn-reseller/list-plans/runmanage_optionsproduct_line: string, currency: string
zinn-reseller/list-sites
zinn-reseller-list-sites
اپنے کلائنٹس کی سائٹس کی فہرست بنائیں
ہر وہ چیز جو آپ نے اپنے کلائنٹس کے لیے فراہم کی ہے (client_id اور status اسے محدود کرتے ہیں)، ایک وقت میں ایک صفحہ کر کے فہرست بناتا ہے۔
مفت ایڈیشن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
کسی کلائنٹ کو کسی پلان پر تفویض کریں
کسی کلائنٹ کو آپ کے منصوبوں میں سے کسی ایک میں شامل کرتا ہے (client_id، plan_code؛ interval: month یا year)۔ ان کی پہلی سائٹ سے پہلے یہ کریں۔
مفت ایڈیشنPOST …/abilities/zinn-reseller/set-client-plan/runmanage_optionsclient_id: string (لازمی), plan_code: string (لازمی), interval: month|year
zinn-reseller/suspend-site
zinn-reseller-suspend-site
کلائنٹ کی سائٹ معطل کریں
کلائنٹ کی سائٹ کو عدم ادائیگی کی بنا پر معطل کر دیتا ہے (site_id؛ reason: آپ کا اپنا نوٹ، جو کلائنٹ کو کبھی نہیں دکھایا جاتا)۔ سائٹ کی سروس معطلی ختم ہونے تک بند رہتی ہے۔
مفت ایڈیشنPOST …/abilities/zinn-reseller/suspend-site/runmanage_optionssite_id: string (لازمی), reason: string
zinn-reseller/unsuspend-site
zinn-reseller-unsuspend-site
کسی کلائنٹ کی سائٹ کو بحال کریں
عدم ادائیگی کی وجہ سے لگائی گئی پابندی کو ہٹاتا ہے، تاکہ سائٹ دوبارہ فعال ہو جائے (site_id)۔
مفت ایڈیشنPOST …/abilities/zinn-reseller/unsuspend-site/runmanage_optionssite_id: string (لازمی)
zinn-reseller/update-settings
zinn-reseller-update-settings
Reseller Toolkit کی ترتیبات تبدیل کریں
آپ کی بھیجی گئی ترتیبات (plan_code، enable_domain_search، enable_panel_link، enable_woocommerce) کو تبدیل کرتا ہے اور باقی کو برقرار رکھتا ہے۔ API کلید اور پتہ صرف اسکرین پر تبدیل ہوتے ہیں۔
مفت ایڈیشنPOST …/abilities/zinn-reseller/update-settings/runmanage_optionsplan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean