المطورون

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

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

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

⁦Zinn®⁩، محارب الفايكنج الخاص بنا، يهتف بينما يتصل مساعد الذكاء الاصطناعي بأدوات المنصة.

نقاط النهاية

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

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/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
تغيير إعدادات مجموعة أدوات الموزع
يغيّر الإعدادات التي ترسلها (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