ڈویلپرز

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

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

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