{"repo":"AhmedElTabarani/dorar-hadith-api","free":true,"listed":false,"github":"https://github.com/AhmedElTabarani/dorar-hadith-api","clone":"git clone https://github.com/AhmedElTabarani/dorar-hadith-api.git","description":"API وسيط للـدرر السنية","language":"JavaScript","stars":119,"topics":["api","search","hadith","islamic"],"license":"MIT","category":"api-integrations-sdks","readme_excerpt":"Dorar.net Hadith API السلام عليكم ورحمة الله وبركاته منذ مدة حاولت استعمال الـ API الخاص بالدرر السنية لكنني واجهت بعض الصعوبات منها أن الـ API يتعامل مع JSONP فقط وأيضًا لن تستطيع التعامل معه بالطرق العادية بسبب الـ CORS وإن نجحت بتجنب الـ CORS باستعمال JSONP فتحصل على الناتج بهيئة HTML وأيضًا لا يوجد documentation أو مستند ما يشرح تفاصيل هذا الـ API وكيفية التعامل معه فأنا قررت عمل API وسيط يتجنب مشكلة CORS ويعطيك البيانات كهيئة JSON بجانب شرح مفصل للـ API وكيفية استخدامه بالاضافة إلى احتواءه على بعض الخصائص الإضافية التي لا توجد في الـ API الرسمي تنبيه - يتم عمل cache لكل عملية بحث لمدة 5 ثواني - هناك حد للاستخدام: 100 عملية بحث في اليوم لكل IP يمكنك تعديلهم من ملف config.js تشغيل الـ API 1. عمل fork أو clone لهذا المشروع 2. تثبيت الـ dependencies 3. أنشئ ملف .env (يمكنك نسخه من .env.example ) وعدّل المتغيرات مثل PORT حسب الحاجة ملاحظة: يتم تحميل .env تلقائيًا عند تشغيل السيرفر عبر dotenv 4. تفقد ملف config.js وقم بتعديل ما تريده 5. تشغيل الـ API 6. الـ API سيكون متوفر على الرابط التالي (افتراضيًا إن لم تغيّر PORT ): 7. استخدمه على localhost كما تريد أو ارفعه على استضافة أو سيرفر خاص بك Documentation Postman الرابط: Postman - استعمل Postman لتعرف كيف تتعامل مع الـ API وترى أمثلة عليه - قم بعمل fork للـ collection لتستخدمه كما تريد - لا تنس تغير الـ environment إلى dev ويمكنك تغير الرابط الخاص بالمتغير {{url}} ان كنت قد غيرته أو غيرت الـ port OpenAPI v3 (Swagger) وثائق API لعرض وثائق API التفاعلية: 1. قم بتشغيل الـ Server : 2. افتح المتصفح وانتقل إلى: ستجد هنا واجهة Swagger","default_branch":null,"files":null,"tree":[],"storefront":"/r/AhmedElTabarani","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/AhmedElTabarani/dorar-hadith-api/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}