المطورون

مرجع قدرات Zinn® Reseller Toolkit

يسجل الإضافة Zinn® Reseller Toolkit إجراءاته باستخدام واجهة برمجة تطبيقات القدرات في WordPress. القدرات ذاتها هي أدوات MCP على خادم الموقع نفسه ومسارات REST ضمن /wp-json/wp-abilities/v1. يتم إنشاء هذه الصفحة من السجل الخاص بالإضافة.

دليل المستخدم: توصيل تطبيق ذكاء اصطناعي

نقاط النهاية

بروتوكول تحكم متعدد عبر بروتوكول نقل النص الفائق (قابل للبث)

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

بروتوكول MCP عبر WP-CLI (الإدخال والإخراج القياسيان)

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 (HTTP Basic). يتطلب الاتصال بخادم 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 الخاص بالإضافة، والذي يتم توليد، بدوره، من موقع قيد التشغيل؛ يفشل الاختبار عندما لا يتطابق الطرفان.

القدرة	ما تفعله	الإصدار	إيقاف مؤقت	إذن	المعاملات
`zinn-reseller/create-client` `zinn-reseller-create-client`	إنشاء عميل ينشئ حساب عميل تحت حسابك (name؛ 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`	قراءة إعدادات مجموعة أدوات الموزع يعيد إعدادات هذا الملحق (عنوان واجهة برمجة التطبيقات، والخطة التي تستخدمها الطلبات الجديدة، والميزات المفعلة). لا يتم إرجاع مفتاح واجهة برمجة التطبيقات أبداً، بل يتم إرجاع ما إذا كان هناك مفتاح مخزناً فقط.	النسخة المجانية	`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 or 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) وتحتفظ بالباقي. يتم تغيير مفتاح واجهة برمجة التطبيقات والعنوان على الشاشة فقط.	النسخة المجانية	`POST …/abilities/zinn-reseller/update-settings/run`	manage_options	plan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean