كيف أقوم بتعيين موضوع عبر واجهة برمجة التطبيقات

يعرض Discourse Assign نقاط النهاية لواجهة برمجة التطبيقات (API) التالية:

تعيين (PUT /assign/assign.json)

المعلمات المطلوبة:

  • target_id - مُعرِّف الموضوع أو المشاركة
  • target_type - إما \"Topic\" أو \"Post\"

بالإضافة إلى واحدة مما يلي:

  • username - اسم المستخدم الذي سيتم التعيين إليه
  • group_name - اسم المجموعة التي سيتم التعيين إليها

المعلمات الاختيارية:

  • note - ملاحظة التعيين
  • status - حالة التعيين
  • should_notify - إرسال الإشعارات (الافتراضي: true)

إلغاء التعيين (PUT /assign/unassign.json)

المعلمات المطلوبة:

  • target_id - مُعرِّف الموضوع أو المشاركة
  • target_type - إما \"Topic\" أو \"Post\"

أمثلة (curl)

# تعيين الموضوع 123 للمستخدم "john"
curl -X PUT "https://your-discourse.com/assign/assign.json" \
  -H "Api-Key: YOUR_API_KEY" \
  -H "Api-Username: YOUR_USERNAME" \
  -H "Content-Type: application/json" \
  -d '{"target_id": 123, "target_type": "Topic", "username": "john"}'

# التعيين لمجموعة بدلاً من ذلك
curl -X PUT "https://your-discourse.com/assign/assign.json" \
  -H "Api-Key: YOUR_API_KEY" \
  -H "Api-Username: YOUR_USERNAME" \
  -H "Content-Type: application/json" \
  -d '{"target_id": 123, "target_type": "Topic", "group_name": "support-team"}'

ملاحظات

  • يجب أن يمتلك مستخدم واجهة برمجة التطبيقات (API) أذونات التعيين (أن يكون في مجموعة مسموح لها بالتعيين)
  • يمكنك أيضًا تعيين مشاركات فردية باستخدام target_type: "Post" مع مُعرِّف المشاركة

@opcourdis مثال Node.js أعلاه يبدو صحيحًا! :+1:

إعجابَين (2)