القرآن

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

قائمة السور

GET/quran/surahs

المعامل	الحالة	الوصف
lang	اختياري	لغة اسم السورة في surah_name. عند عدم تحديدها، تُعرض الأسماء بالعربية.

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

[
  { "surah_no": 1, "surah_name": "Al-Faatiha", "ar_uthmani_name": "ﰀ", "ayas_count": 7 },
  { "surah_no": 2, "surah_name": "Al-Baqara", "ar_uthmani_name": "ﰁ", "ayas_count": 286 }
]

يحتوي ar_uthmani_name على رمز يتطلب خطًا خاصًا بأسماء السور. استخدم الخط المناسب لعرضه، أو اعرض الاسم النصي بدلًا منه.

سورة بآياتها

GET/quran/surahs/{surahNo}

المعامل	الحالة	الوصف
surahNo	معامل مسار	من 1 إلى 114.
lang	اختياري	يُرجع جميع إصدارات الترجمة باللغة المحددة. عند عدم تحديده، يُرجع النص العربي فقط.
langKey	اختياري	يُرجع إصدارًا واحدًا بمفتاحه مثل english_hilali_khan (انظر إصدارات الترجمة أدناه).

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

{
  "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", "arabicName": "إنجليزي", "englishName": "English", "nativeName": "English", "direction": "ltr" }
          },
          "content": "1. Say (O Muhammad صلى الله عليه وسلم): \"He is Allâh, (the) One.",
          "footnotes": null
        }
      ]
    }
  ]
}

الحقل	المعنى
aya_uthmani	النص العثماني بعلامات الوقف والحروف الصغيرة كما في مصحف المدينة. يحتاج خطًا قرآنيًا (KFGQPC Uthmanic، Amiri Quran) ليظهر صحيحًا.
aya_imlaei	الآية نفسها بالرسم الإملائي الحديث: تصلح للبحث وتُقرأ بأي خط عربي.
aya_no_uthmani	رقم الآية بالأرقام العربية المشرقية.
translations[].content	النص المترجم. بعض الترجمات تُبقي رقم الآية في بداية النص. ويحمل footnotes حواشي الترجمة إن وُجدت.

يُرجع المسار بـ404 إذا كان رقم السورة خارج المدى من 1 إلى 114.

إصدارات الترجمة

GET/quran/translation-keys

يعرض إصدارات الترجمة المتاحة، وعددها 70 إصدارًا، مع اللغة المرتبطة بكل إصدار.

[
  { "key": "afar_hamza", "title": "الترجمة العفرية - محمود عبدالقادر حمزة", "language": { "isoCode": "aa", "englishName": "Afar", "direction": "ltr" }, "last_version": "1.0" },
  { "key": "english_hilali_khan", "title": "الترجمة الإنجليزية - تقي الدين الهلالي ومحسن خان", "language": { "isoCode": "en", "englishName": "English", "direction": "ltr" }, "last_version": "1.0" }
]

استخدم key في معامل langKey عند طلب السورة لتحصل على ذلك الإصدار تحديدًا.

أسماء السور بكل لغة

GET/quran/surah-names

المعامل	الحالة	الوصف
language	اختياري	رمز ISO. يُرجع الرمز 404 إذا كان غير معروف.
surah_no	اختياري	من 1 إلى 114. يُرجع الرمز 404 إذا كان غير معروف.
q	اختياري	جزء من الاسم، دون تمييز بين الأحرف الكبيرة والصغيرة.

عند إرسال الطلب دون معاملات، تُرجع الاستجابة أسماء جميع السور باللغات الـ78 (8,892 سجلًا، بحجم يقارب 540 كيلوبايت). استخدم language للحصول على الأسماء بلغة واحدة.

curl "https://islamenc.com/api/quran/surah-names?language=fr"

[ { "surah_no": 1, "language": "fr", "surah_name": "Al-Fatiha" }, ... ]

البحث في الآيات

GET/quran/search

البحث الدلالي في الآيات وحدها: بالكلمات والمعنى، في العربية والترجمات معًا.

المعامل	الحالة	الوصف
q	مطلوب	السؤال أو الكلمات.
limit	اختياري	من 1 إلى 50، والافتراضي 10.
lang	اختياري	لغة الترجمة في translation المرفقة بكل آية (الافتراضي en).

curl "https://islamenc.com/api/quran/search?q=الصبر&limit=2&lang=en"

{
  "query": "الصبر",
  "semantic": true,
  "results": [
    {
      "type": "aya",
      "score": 0.7873,
      "surah_no": 70,
      "aya_no": 5,
      "surah_name": "المَعَارج",
      "aya_uthmani": "فَٱصۡبِرۡ صَبۡرٗا جَمِيلًا",
      "translation": "5. So be patient (O Muhammad صلى الله عليه وسلم), with a good patience.",
      "matched_lang": "ar"
    }
  ],
  "timings": { "embed": 212, "meili": 120, "rerank": 0, "db": 7, "total": 339 }
}

تكون قيمة semantic هي false إذا اقتصر البحث على الكلمات بسبب عدم اكتمال تحليل معنى السؤال في الوقت المحدد. أعد إرسال السؤال بعد قليل للحصول على نتائج البحث بالمعنى. ويوضح matched_lang لغة النص المطابق: العربية أو إحدى لغات الترجمة.

إن أردت التصفية بالسورة أو أنواع نتائج أخرى أو تقسيم النتائج إلى صفحات، استخدم /hybrid-search?type=aya مباشرة.