تُنشأ مفاتيح واجهة برمجة التطبيقات (API) من صفحة المسؤول / واجهة برمجة التطبيقات. انتقل إلى المسؤول - متقدم - مفاتيح واجهة برمجة التطبيقات:
بعد النقر على زر “مفتاح واجهة برمجة تطبيقات جديد”، سيتم نقلك إلى صفحة لتكوين المفتاح:
يحتاج كل مفتاح واجهة برمجة تطبيقات إلى وصف ومستوى مستخدم ونطاق.
الوصف
يمكن أن يكون الوصف أي شيء تختاره.
مستوى المستخدم
تسمح القائمة المنسدلة لمستوى المستخدم باختيار “جميع المستخدمين” أو “مستخدم واحد”. إذا تم تحديد “جميع المستخدمين”، فيمكن استخدام المفتاح نيابة عن أي مستخدم. يتم ذلك عن طريق تعيين المستخدم الذي تجري الطلب نيابة عنه كـ Api-Username في رؤوس الطلب. (راجع مثال المصادقة في وثائق واجهة برمجة التطبيقات للحصول على تفاصيل حول كيفية تعيين رؤوس الطلب.)
إذا تم تحديد “مستخدم واحد”، فسيظهر حقل مستخدم في النموذج. أدخل اسم المستخدم للمستخدم الذي تقوم بإنشاء مفتاح واجهة برمجة التطبيقات له في هذا الحقل:
النطاق
تسمح القائمة المنسدلة للنطاق باختيار “مفصل” أو “للقراءة فقط” أو “شامل” كنطاق.
إذا تم تحديد “للقراءة فقط” كنطاق، فلن يتمكن مفتاح واجهة برمجة التطبيقات من استخدامه إلا لإجراء طلبات GET. سيتمكن المفتاح من إجراء أي طلبات GET يمتلك المستخدم الذي تم إنشاء المفتاح له، أو اسم المستخدم المدخل كـ Api-Username للطلب، الإذن للقيام بها.
إذا تم تحديد “شامل” كنطاق، فيمكن استخدام المفتاح لـ جميع الطلبات التي يمتلك المستخدم الذي تم إنشاء المفتاح له، أو اسم المستخدم المدخل كـ Api-Username للطلب، الإذن للقيام بها.
إذا تم تحديد “مفصل” كنطاق، فسيتم فتح نموذج يسمح لك بالاختيار من بين النطاقات المتاحة. مرر فوق أيقونة علامة الاستفهام الخاصة بالنطاق لرؤية وصف للنطاق. انقر على أيقونة الرابط الخاصة بالنطاق لرؤية قائمة بالمسارات وطرق الطلب التي يدعمها النطاق. لاحظ أن العديد من النطاقات تسمح لك بإدخال معلمة إضافية لتحديد مسارات الموقع التي سيسمح النطاق بالوصول إليها:
بعد تكوين مفتاح واجهة برمجة التطبيقات والنقر على زر الحفظ، سيتم عرض مفتاح واجهة برمجة التطبيقات الكامل لك مرة واحدة. تأكد من نسخ المفتاح لأنه لا توجد طريقة لعرض المفتاح الكامل مرة أخرى.
يمكن لنطاقات واجهة برمجة التطبيقات في Discourse تقييد فقط الإجراءات التي يمكن لمفتاح واجهة برمجة التطبيقات تنفيذها فيما يتعلق بالأذونات الحالية للمستخدم. لا يمكنها منح أذونات إضافية تتجاوز ما يمتلكه المستخدم المرتبط بالفعل.
قراءة إضافية
تفاصيل حول حدود المعدل التي يطبقها Discourse على مفاتيح واجهة برمجة التطبيقات: حدود المعدل الشاملة والتنظيم في Discourse.
وثائق واجهة برمجة تطبيقات Discourse: https://docs.discourse.org/.
دليل مفيد لمعرفة كيفية هيكلة طلبات واجهة برمجة التطبيقات: كيفية هندسة واجهة برمجة تطبيقات Discourse العكسية.
.
