واجهة موسوعة المحتوى الإسلامي البرمجية

https://islamenc.com/api

القرآن114 سورة، كل آية بالرسم العثماني والإملائي، الترجمات بإصداراتها، وأسماء السور بـ78 لغة.

الكتبالفهرس، فصول كل كتاب وفقراته، ترجماته عبارةً بعبارة، وملفات PDF وWord.

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

البحثبحث دلالي يفهم المعنى في كل المحتوى، وبحث بالكلمات، واقتراحات أثناء الكتابة، وعدد النتائج في كل تصنيف.

معلومات أساسية

العنوان الأساسي	https://islamenc.com/api
الصيغة	JSON بترميز UTF-8. يُرجع النص العربي كما ورد في المصدر، وبالرسم العثماني حيث يوجد.
المصادقة	غير مطلوبة. جميع المسارات الواردة في هذا التوثيق عامة وللقراءة فقط.
حد الطلبات	10 طلبات في الثانية لكل عنوان IP، مع السماح بدفعات قصيرة تصل إلى 40 طلبًا. ما زاد على ذلك يُرفض بالرمز 429.
CORS	مفعّل لكل المصادر، فيمكنك استدعاء الواجهة من المتصفح مباشرة.
التخزين المؤقت	أغلب الاستجابات تحمل Cache-Control: public, max-age=600. المحتوى يتغير بضع مرات في الأسبوع، ويمكن تخزين الاستجابات مؤقتًا وفقًا للترويسة.
لأدوات الذكاء الاصطناعي	هذا التوثيق كاملًا بصيغة Markdown في /llms.txt و/llms-full.txt، ووصف الواجهة بصيغة OpenAPI في /openapi.json.
الشروط	الاستخدام مجاني مع ذكر المصدر. انظر شروط الاستخدام.

أول طلب

curl

curl "https://islamenc.com/api/quran/surahs/112?lang=en"

JavaScript

const res = await fetch("https://islamenc.com/api/quran/surahs/112?lang=en");
const { surah, ayahs } = await res.json();
console.log(surah.surah_name, ayahs.length); // الإخلَاص 4

Python

import requests

r = requests.get("https://islamenc.com/api/quran/surahs/112", params={"lang": "en"})
data = r.json()
print(data["surah"]["surah_name"], len(data["ayahs"]))

{
  "surah": { "surah_no": 112, "surah_name": "الإخلَاص", "ar_uthmani_name": "ﰝ", "ayas_count": 4 },
  "ayahs": [
    {
      "id": 12458,
      "aya_no": 1,
      "aya_no_uthmani": "١",
      "aya_uthmani": "قُلۡ هُوَ ٱللَّهُ أَحَدٌ",
      "aya_imlaei": "قُلْ هُوَ اللَّهُ أَحَدٌ",
      "translations": [
        {
          "id": 872051,
          "translationKey": { "key": "english_hilali_khan", "title": "الترجمة الإنجليزية - تقي الدين الهلالي ومحسن خان", "language": { "isoCode": "en", "englishName": "English", "direction": "ltr" } },
          "content": "1. Say (O Muhammad صلى الله عليه وسلم): \"He is Allâh, (the) One.",
          "footnotes": null
        }
      ]
    }
  ]
}

التالي: ابدأ من هنا

تعرّف على اللغات والمعرّفات وتقسيم النتائج والأخطاء وحد الطلبات. اقرأ الدليل.

جرّب من المتصفح

جرّب أي مسار من المتصفح مباشرة في صفحة OpenAPI.