تخطَّ إلى المحتوى

تشغيل أداة قناة

POST /public/v1/integration-trigger/{id}

ينفذ إحدى الأدوات المساعدة الخاصة بمزود القناة. وهذه هي عمليات البحث التي يستخدمها المحرر لملء قائمة منسدلة: مجتمعات subreddit التي تستطيع النشر إليها، ولوحات Pinterest التي تملكها، وقنوات Discord التي يراها البوت.

وتحتاجها لأن عدة مزودين يشترطون قيمة في settings لا تعرفها إلا المنصة. وهذه طريقتك في جلب الخيارات الصالحة بدل التخمين.

وهذه العملية متاحة أيضًا بالأمر sharek integrations:trigger في أداة CLI من شارك، وبالأداة triggerTool في خادم MCP من شارك.

المعامل مطلوب الوصف
id نعم معرف التكامل من سرد القنوات.
الحقل مطلوب الوصف
methodName نعم الأداة التي تنفذ. اكتشف الأسماء الصالحة من مصفوفة tools في إعدادات القناة.
data لا معاملات الأداة، بالشكل الذي يحدده dataSchema الخاص بها. والقيمة الافتراضية {}.
Terminal window
curl -X POST https://dash.sharek.app/api/public/v1/integration-trigger/channel-id \
-H "Authorization: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"methodName": "subreddits",
"data": { "word": "marketing" }
}'

القيمة التي يعيدها المزود نفسه، مغلفة:

{ "output": [ { "id": "...", "name": "..." } ] }

والشكل داخل output هو ما تعيده تلك الأداة أيًا كان، لذا اقرأ dataSchema من إعدادات القناة بدل افتراض صيغة موحدة.

الاستجابة المعنى
404 {"msg": "Integration not found"} لا قناة بهذا المعرف في مؤسستك.
404 {"msg": "Integration provider not found"} القناة موجودة لكن مزودها لم يعد معروضًا.
404 {"msg": "Tool not found"} لا أداة لدى المزود بقيمة methodName تلك. والأسماء تراعي حالة الأحرف.
401 {"msg": "Channel disconnected due to expired token"} انتهى رمز القناة وتعذر تجديده، فقطع شارك اتصال القناة. أعد ربطها في التطبيق.
500 {"msg": "Unexpected error"} أخفقت الأداة لسبب آخر، كخطأ من المنصة.

الرموز المنتهية تعالج نيابةً عنك

Section titled “الرموز المنتهية تعالج نيابةً عنك”

إن انتهى رمز وصول القناة، جدده شارك وأعاد تنفيذ الأداة تلقائيًا، فرمز الوصول القديم ليس شيئًا عليك معالجته. وإن فشل التجديد نفسه، قطع اتصال القناة وظهرت في التطبيق على أنها تحتاج انتباهًا، وأجاب الاستدعاء بـ 401.