الرئيسية / واجهة البرمجة
واجهة البرمجة (API v1)
واجهة برمجة عامة للباحثين — JSON، قراءة فقط، بلا مصادقة، وتدعم CORS.
كل نقاط النهاية تعيد application/json عبر طلبات GET، وتسمح بالوصول من أي أصل (CORS مفعّل)، وتُخزَّن مؤقتًا خمس دقائق. البيانات عامة (الفهرس الببليوغرافي والنصوص المسندة). نرجو الاستخدام المسؤول وذكر «مكتبة العلوم النبوية» مصدرًا عند إعادة النشر.
GET
/api/v1/searchبحث نصي كامل في صفحات المكتبة، يعيد المطابقات بعزوها (الكتاب والجزء والصفحة) ورابط الموضع في القارئ.
| المعامل | الوصف |
|---|---|
q | نص البحث (إلزامي) — يتجاوز التشكيل والهمزات |
book | حصر في كتاب (slug) |
cat | حصر في تصنيف (slug) |
page / perPage | الترقيم (perPage ≤ 50) |
GET
/api/v1/worksقائمة الأعمال الببليوغرافية مع الترشيح.
| المعامل | الوصف |
|---|---|
cat | تصنيف (slug) |
author | مؤلف (slug) |
availability | مستوى الإتاحة: TEXT_AND_SCAN, TEXT_ONLY, SCAN_ONLY, PRINT_ONLY, MANUSCRIPT_ONLY, LOST, UNKNOWN |
q | بحث في العنوان |
page / perPage | الترقيم (perPage ≤ 100) |
GET
/api/v1/works/{slug}بطاقة عمل كاملة: المؤلف والتصنيفات والطبعات المحققة والنسخ الرقمية والعلاقات (شروح/مختصرات/أصول).
مثال /api/v1/works/dalail-albayhaqi