إرشادات إستخدام بوابة دار الإسلام للمطوريين

مقدمة

توفر بوابة دار الإسلام للمطورين واجهة متكاملة للمطورين الذين يريدون إنشاء مواقعهم او تطبيقاتهم بناءا على ما يوفره موقع دار الإسلام من محتويات تم مراجعتها بدقة ونشرها وترجمتها ولكي يمكنك الإستفادة من هذه المحتويات بسهوله ويسر يجب إتباع الخطوات التالية.

التسجيل

لكي يمكنك الإستفادة من المحتويات يجب أولا التسجيل في الموقع من خلال الرابط http://api.islamhouse.com/ar/auth/signup/ وإدخال البيانات الخاصة بك

تسجيل الدخول

بعد الإنتهاء من عملية التسجيل بنجاح سيتم تحويلك إلى صفحة الدخول حيث تقوم بإدخال بيانات الدخول وتسجيل الدخول للبوابة.

لوحة التحكم

عندما تقوم بتسجيل الدخول بنجاح يتم تحويلة مباشرة إلى الصفحة الإفتراضية للدخول وهي الصفحة الخاصة بالتطبيقات والتعامل معها حيث يمكن البدء في إنشاء التطبيقات الخاصة بك أو ادارتها ويمكن ايضا تغيير الإعدادات الخاصة بك وكلمة المرور والبريد الإلكتروني والملف الشخصي .

إنشاء تطبيق جديد

لكي يمكن التعامل مع البوابة يجب الحصول على مفتاح إتصال وهذا المفتاح يعتبر الهوية الخاصة بك احتفظ به ولا تخبر به احدا لأنه يُعد المعرف الخاص بك والذي يمكنك من التعامل مع الموقع لكي تحصل على مفتاح الإتصال قم بالضغط على زر تطبيق جديد سيتم تحويلك إلى الصفحة الخاصة بإنشاء تطبيق جديد حيث تقوم بإدخال إسم التطبيق والوصف الخاصة به والموقع ان وُجد وهذه البيانات تساعد دار الإسلام في التعرف على التطبيقات المنشأة ومراجعتها حيث يجب الإلتزام بإدخال بيانات حقيقية او صحيحة إن أمكن وإلا ستُعرض أن يتم إيقاف التطبيق الخاص بك.

البدء في استخدام مفتاح الإتصال

بعد إنشاء التطبيق الخاص بك يتم تحويلك إلى لوحة التحكم الخاصة بالتطبيقات حيث يظهر لك إسم التطبيق ومفتاح الإتصال الخاص بك حيث يكون بالشكل التالي 54N4jsgRqB0yhh5lJ كل تطبيق له مفتاح إتصال خاص به حيث لا يمكن الإتصال بالموقع إلا من خلال إستخدام مفتاح إتصال مفعل ( مثل ما يحدث في تويتر وفيس بوك ) ويفضل أن يكون لكل خدمة أو تطبيق المفتاح الخاص به لأنه لدينا حد أقصى من عدد الطلبات في الساعة الواحدة وهو 5000 ويمكن زيادته حسب الطلب وذلك لحماية السيرفر واستخدام نفس المفتاح في جميع التطبيقات قد يؤدي إلى الوصول للحد الأقصى وإيقاف الخدمة حتى مرور ساعة لأن هذا العدد هو العدد المخصص في الساعة الواحدة . رابط البوابة يكون بالشكل التالي http://api.islamhouse.com/v1/54N4jsgRqB0yhh5lJ وهذا الرابط ثابت في جميع الروابط ويلاحظ أن مفتاح الإتصال الخاص بكم هو 54N4jsgRqB0yhh5lJ يرجى الإحتفاظ به وعدم إعطاؤه لأحد ويمكنكم انشاء حساب ومفتاح خاص بكم واستبداله او تغييره في أي وقت من لوحة التحكم قم بإستبدال مفتاح الإتصال الخاص بك بالمفتاح المذكور في المثال حيث ان هذا المفتاح لمجرد الشرح وغير مسموح إستخدامه في عملية الإتصال

ملاحظة :-

في حالة اذا كنت تستخدم أحد البرمجيات الجاهزة التي تقوم بجلب محتويات الموقع ما عليك إلا وضع هذا المفتاح بها لكي يمكنك إستخدام الموقع
مثال على نموذج للتطبيقات

شروط الإستخدام

- يفضل أن تقوم بفصل الخدمات الخاصة بك والمواقع كل خدمة او موقع او تطبيق بمفتاح اتصال خاص به بحيث تضمن عدم توقف الخدمات الخاصة بك نظرا لإستخدامها مفتاح إتصال واحد وعليه عدد طلبات كبير
- يجب الإشارة إلى بوابة دار الإسلام في التطبيق الخاص بك ووضع الرابط الخاصة بها http://api.islamhouse.com
- في حالة برمجة موقع بالكامل مثل دار الإسلام يجب الإشارة في الكود البرمجي للرابط الأصلي للمادة حتى يتم أرشفة المادة بصورة صحيحة دون إلحاق أي ضرر بموقع دار الإسلام