الوصول إلى المحتوى ونسبته

مقالات عامة، ومراجع واضحة، ورابط ثابت يعود إلى الأصل.

اقرأ واكتشف

تتضمن صفحات المقالات نصوصًا ومراجع قابلة للقراءة دون الحاجة إلى JavaScript أو حساب للمقالات العامة. اعثر على المجموعة الكاملة في أرشيف المقالات، وعناوين URL الأساسية في خريطة الموقع، وآخر 50 مقالًا في خلاصة RSS، وفهرس نصي في llms.txt.

واجهة API للمقالات للقراءة فقط

لا يتطلب تصدير المقالات العامة مفتاح API. أرسل طلب GET إلى /api/public/articles/ARTICLE-SLUG للحصول على JSON، أو أضف ?format=markdown للحصول على Markdown. وتستند هذه الصيغ إلى المقال المحفوظ نفسه الذي تعرضه صفحة القراءة، مع الاحتفاظ بالعناوين والقوائم والروابط ونِسب الصور والإفصاحات التحريرية.

جرّب مثال JSON، ونسخته بصيغة Markdown، والمقال الأصلي.

يتضمن JSON الحقل url (صفحة القراءة الأساسية)، والعنوان، والوصف، والكاتب، والناشر، واللغة، والموضوع، وpublishedAt، وmodifiedAt، وbody.format، وbody.text، وروابط المقال links. والروابط مراجع واردة في النص؛ ولا يعني وجودها أن كل صفحة مرتبطة تدعم كل عبارة. وتتبع جميع التواريخ معيار ISO 8601.

اعرض قائمة المقالات وتابع التحديثات

اطلب /api/public/articles?limit=24 للحصول على البيانات الوصفية فقط. الحد الافتراضي هو 6، والحد الأقصى 24. استخدم page=2 للصفحة التالية. يقبل المعامل الاختياري topic الاسم المختصر للموضوع، ويقبل author معرّف كاتب موجبًا. وتتضمن الاستجابة docs وhasNextPage وtotalPages وnextAfter.

لمتابعة التصفح بين الصفحات، مرّر القيمة المُعادة في nextAfter.at إلى afterAt، والقيمة في nextAfter.id إلى afterId، مع ترميز القيمتين لاستخدامهما في عنوان URL. وأبقِ عوامل التصفية والحد كما هما. واصل ما دامت قيمة hasNextPage هي true. ولا يتيح عرض قائمة البيانات الوصفية الوصول إلى النصوص المقيّدة للمقالات.

حدود الوصول وحداثة المحتوى

لا تتاح نقطة نهاية النص الكامل إلا للمقالات العامة المنشورة التي حان وقت نشرها. وتُعيد المقالات غير المعروفة والمسودات والمقالات المجدولة ونصوص المقالات المخصصة لأصحاب الحسابات أو الأعضاء الرمز 404. وتُعيد الصيغ أو معاملات القائمة غير الصالحة الرمز 400. تقبل نقطة النهاية GET وHEAD؛ ولا تدعم طرق الكتابة. ولا يتيح تسجيل الدخول تصدير محتوى غير متاح للتصدير.

تُولّد النسخ المصدّرة عند الطلب وتستخدم Cache-Control: no-store لإعادة التحقق من النصوص المصححة وتغييرات الوصول. وتحدد ترويسة HTTP المسماة Link صفحة HTML الأساسية. يُرجى جلب المحتوى بالتتابع، وتجنّب التنزيلات الجماعية المتكررة، والانتظار قليلًا قبل إعادة المحاولة عند حدوث أعطال مؤقتة في الخادم.

النسبة والمصادر وإعادة الاستخدام

عند الإشارة إلى مقال، استخدم عنوان URL الأساسي له، وعنوانه، واسم الكاتب المذكور، وتاريخ النشر؛ وسجّل تاريخ التعديل عندما تكون له أهمية في مرجعك. وحافظ على التمييز بين النص القرآني، والترجمة، والمصدر المرتبط، وشرح المنصة نفسه. وتعرّف أسماء جهات التحرير الواردة في خانة الكاتب بفرق العمل، ولا تدل على مؤهلات علمية لأفراد بعينهم.

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

لا يغيّر إتاحة المحتوى للجميع حقوق النشر، ولا يمنح ترخيصًا لإعادة نشر مقالات كاملة أو إزالة نِسب الأعمال إلى أصحابها. شارك الروابط واستخدم الاقتباسات المشروعة مع نسبتها إلى أصحابها وفق شروطنا. ويمكن تقديم طلبات التصحيح أو الإذن من خلال المساعدة.