للمطورين
واجهة قراءة عامة مجانية لمنصات المحتوى الإسلامي ومراكز البحث وتطبيقات الذكاء الاصطناعي: ابنِ على نص موثق يعود كل مقطع فيه إلى صفحته المطبوعة.
- الصيغة
- JSON · قراءة فقط · بلا مفتاح
- التوثيق التفصيلي
/docs(OpenAPI)- الشرط
- اذكر الكتاب والطبعة ورقم الصفحة عند العرض
GET /api/v1/search?q=شروط التوبة&k=3
بحث هجين (كلمات + معنى) في الكتاب المفهرس. كل نتيجة تحمل توثيق الصفحة والمربعات المحيطة بكتلها على صورة الصفحة الأصلية.
curl "https://<your-asool-api>/api/v1/search?q=شروط التوبة&k=3"
{
"query": "شروط التوبة",
"results": [{
"id": "riyad1956-c013",
"kind": "matn",
"author_label": "متن الإمام النووي",
"breadcrumb": ["رياض الصالحين", "باب التوبة"],
"text": "قال العلماء : التوبةُ(١) واجبةٌ منْ كلِّ ذنبٍ …",
"pages": [{"id": "riyad1956-p018", "printed": 18,
"citation": "رياض الصالحين، الإمام يحيى بن شرف النووي، …، ص 18"}],
"blocks": [{"id": "riyad1956-p018-b03", "type": "body",
"bbox": [412, 640, 1760, 1488], "bbox_source": "fusion"}],
"footnotes": [{"footnote_marker": "(١)", "text": "القرب إلى الله بالطاعة …"}],
"quran": [], "hadith": []
}],
"attribution": "Asool (أصول) — رياض الصالحين، طبعة 1956. Cite the printed page."
}GET /api/v1/passages/riyad1956-c013
نص كامل لمقطع مع كتله وحواشيه وفحص الآيات وحكم الأحاديث ومواضعها في الصفحات.
curl "https://<your-asool-api>/api/v1/passages/riyad1956-c013"
{ "id": "riyad1956-c013", "kind": "matn", "pages": [...], "blocks": [...], "footnotes": [...] }الحدود والاستخدام العادل
- نقاط البحث والمقاطع لا تستدعي نماذج لغوية مولِّدة؛ نقطة الإجابة الداخلية محدودة لكل عنوان IP (٢٠ إجابة جديدة في الساعة).
- النصوص منقولة حرفيًا من الطبعة المطبوعة؛ لا تُعدَّل، والحواشي من تعليق المحقق مصطفى محمد عمارة.
- لا نجمع بيانات شخصية ولا نتتبع المستخدمين.