\u003cdiv data-theme-toc="true"\u003e \u003c/div\u003e
إذًا، أنت ترغب في استخدام واجهة برمجة تطبيقات ديسكورس (Discourse API)؟ ممتاز! لنبدأ.
إعداد بيئة تطوير ديسكورس
قم بإعداد بيئة تطوير ديسكورس باستخدام دليل ويندوز (Windows) أو ماك أو إس (macOS) أو أوبونتو (Ubuntu).
استنساخ مكتبة ديسكورس البرمجية لواجهة برمجة التطبيقات (Discourse API Gem)
الآن بعد أن قمت بإعداد بيئة تطوير ديسكورس، يجب أن يكون لديك Git و Ruby مثبتين بالفعل على نظامك. يمكنك تثبيت مكتبة ديسكورس البرمجية لواجهة برمجة التطبيقات عن طريق تشغيل الأمر التالي من وحدة التحكم (console):
git clone https://github.com/discourse/discourse_api.git ~/discourse_api
بدلاً من ذلك، يمكنك تثبيت المكتبة البرمجية مباشرةً:
gem install discourse_api
تثبيت التبعيات
افتح دليل discourse_api واكتب:
bundle install
سيؤدي هذا إلى تثبيت أي تبعيات مطلوبة للمكتبات البرمجية (gems).
إنشاء مفتاح واجهة برمجة التطبيقات (API Key)
قم بإنشاء مفتاح واجهة برمجة تطبيقات (API Key) لمثيل ديسكورس الخاص بك عن طريق زيارة /admin/api/keys، للتفاعل مع واجهة برمجة تطبيقات ديسكورس (Discourse API).
توفير بيانات اعتماد واجهة برمجة التطبيقات
الآن بعد أن قمت باستنساخ مكتبة ديسكورس البرمجية لواجهة برمجة التطبيقات (Discourse API gem) وأنشأت مفتاح واجهة برمجة تطبيقات، فلنبدأ في استخدامه!
افتح الملف discourse_api/examples/example.rb، وقم بتعديل المعلومات التالية:
client = DiscourseApi::Client.new("http://localhost:3000")
client.api_key = "YOUR_API_KEY"
client.api_username = "YOUR_USERNAME"
استبدل http://localhost:3000 بعنوان URL لمثيل ديسكورس الخاص بك، على سبيل المثال: http://discourse.example.com
استبدل YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات لمثيل ديسكورس الخاص بك، على سبيل المثال: b1f3175cb682b3e9b6ca419db77772120b19af993cbc14ebed80fea08e3bbd66
استبدل YOUR_USERNAME باسم المستخدم المسؤول (Admin username) لمثيل ديسكورس الخاص بك، على سبيل المثال: codinghorror
الوصول إلى واجهة برمجة تطبيقات ديسكورس (Discourse API)
الآن في وحدة التحكم (console)، من دليل discourse_api قم بتشغيل:
ruby examples/example.rb
سيؤدي هذا الأمر إلى طباعة أحدث المواضيع من مثيل ديسكورس الخاص بك.
هذا كل شيء. ابدأ باستخدام واجهة برمجة تطبيقات ديسكورس (Discourse API) اليوم.
مصادر إضافية:
وثائق واجهة برمجة تطبيقات ديسكورس (Discourse API Documentation)
آخر مراجعة بواسطة @SaraDev في 2022-07-13T01:00:00Z