المطورون
مرجع قدرات 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-resellerREST: تشغيل قدرة
/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-clientzinn-reseller-create-client | إنشاء عميل ينشئ حساب عميل تابعاً لحسابكم (name؛ وdefault_currency، رمز مكون من ثلاثة أحرف). قوموا بتعيين خطة لهم قبل إنشاء موقعهم الأول. | النسخة المجانية | POST …/abilities/zinn-reseller/create-client/run | manage_options | name: string (مطلوب), default_currency: string |
zinn-reseller/create-sitezinn-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-planzinn-reseller-get-client-plan | قراءة خطة عميل يعرض الخطة التي يشترك فيها العميل وتكلفتها بالنسبة لك (client_id). | النسخة المجانية | GET …/abilities/zinn-reseller/get-client-plan/run | manage_options | client_id: string (مطلوب) |
zinn-reseller/get-overviewzinn-reseller-get-overview | قراءة حساب الموزع الخاص بك يعرض حساب الموزع الخاص بك في قراءة واحدة: العلامة التجارية، والخطط، وأعداد العملاء والخدمات، وما تم إعداده. | النسخة المجانية | GET …/abilities/zinn-reseller/get-overview/run | manage_options | لا شيء |
zinn-reseller/get-settingszinn-reseller-get-settings | قراءة إعدادات Reseller Toolkit يُرجع إعدادات هذه الإضافة (عنوان API، والخطة التي تستخدمها الطلبات الجديدة، والميزات المفعّلة). لا يُرجع مفتاح API أبدًا، بل يُرجع فقط ما إذا كان محفوظًا أم لا. | النسخة المجانية | GET …/abilities/zinn-reseller/get-settings/run | manage_options | لا شيء |
zinn-reseller/list-clientszinn-reseller-list-clients | عرض عملائك يعرض حسابات عملائك، صفحة واحدة في كل مرة (cursor، limit). | النسخة المجانية | GET …/abilities/zinn-reseller/list-clients/run | manage_options | cursor: string, limit: integer |
zinn-reseller/list-planszinn-reseller-list-plans | عرض الخطط التي يمكنك بيعها يعرض خطط الاستضافة وأسعارها (يقوم product_line و currency بتضييق النطاق). | النسخة المجانية | GET …/abilities/zinn-reseller/list-plans/run | manage_options | product_line: string, currency: string |
zinn-reseller/list-siteszinn-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-planzinn-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-sitezinn-reseller-suspend-site | تعليق موقع عميل يضع موقع العميل في حالة تعليق لعدم السداد (site_id؛ reason: ملاحظتكم الخاصة، لا تظهر للعميل أبدًا). يتوقف الموقع عن العمل حتى يتم إلغاء تعليقه. | النسخة المجانية | POST …/abilities/zinn-reseller/suspend-site/run | manage_options | site_id: string (مطلوب), reason: string |
zinn-reseller/unsuspend-sitezinn-reseller-unsuspend-site | إلغاء تعليق موقع عميل يرفع تعليق عدم السداد، ليعود الموقع للعمل مجددًا (site_id). | النسخة المجانية | POST …/abilities/zinn-reseller/unsuspend-site/run | manage_options | site_id: string (مطلوب) |
zinn-reseller/update-settingszinn-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 |