يمكن منح الشارات المخصصة التي أنشأتها في منتداك عبر واجهة برمجة التطبيقات (API). تُعد هذه طريقة ممتازة لمنح الشارات دون الحاجة إلى استخدام أوامر SQL مخصصة للشارات.
لمنح شارة عبر واجهة برمجة التطبيقات، تحتاج إلى معرفة اسم المستخدم للمستخدم الذي ترغب في منح الشارة له، ومعرف الشارة (أو اسمها) التي ترغب في منحها. كما يجب التأكد من أنك قمت بتوليد مفتاح API من قسم الإدارة > واجهة برمجة التطبيقات > المفاتيح في موقعك (/admin/api/keys).
العثور على معرف الشارة
يمكنك الحصول على معرف الشارة من رابط الشارة. انتقل إلى قسم الإدارة/الشارات في موقعك، ثم انقر على الشارة التي ترغب في منحها. سيبدو الرابط شبيهاً بهذا: https://forum.example.com/admin/badges/102. الرقم الأخير في الرابط هو معرف الشارة.
إجراء مكالمة واجهة برمجة التطبيقات
لاختبار مكالمة واجهة برمجة التطبيقات، يمكنك تجربة منح شارة باستخدام أداة curl أو Postman. إليك كيفية منح شارة من طرفي في سطر الأوامر باستخدام curl.
أولاً، لتسهيل الأمر، قم بتعيين متغير api_key:
api_key=yourapikey
ثم لمنح شارة بمعرف 102 للمستخدم bobby:
curl -X POST "https://forum.example.com/user_badges" \
-H "Api-Key: $api_key" \
-H "Api-Username: system" \
-F "username=bobby" \
-F "badge_id=102" \
-F "reason=https://forum.example.com/t/whats-the-best-photo-youve-ever-taken/160/2"
بدلاً من badge_id، يمكنك أيضاً استخدام badge_name لتحديد الشارة باسمها:
-F "badge_name=My Custom Badge"
المعلمة reason اختيارية. إذا قمت بتزويدها، فيجب تعيينها إلى رابط موضوع أو منشور في موقعك.
يجب أن تتلقى استجابة بصيغة JSON تحتوي على تفاصيل حول الشارة وتاريخ منحها.