واجهة القراءات القرآنية · الإصدار ١

القرآن الكريم بالقراءات العشر، في واجهة برمجية واحدة

نص مركّب للروايات العشرين من القراءات العشر، مع تمييز مواضع الاختلاف بينها كلمةً كلمة. مصمَّمة للتطبيقات والمواقع والبحث العلمي.

احصل على بيانات الدخول اقرأ التوثيق

ليس لديك حساب؟ اطلب الوصول · [email protected]

الطلب
GET /api/v1/chapters/1/text?readingId=2&recitationId=3&countingId=1&compareWithHafs=true

رواية ورش مقارنةً برواية حفص

مَلِكِ يَوْمِ الدِّينِ

الاستجابة

{
  "chapterId": 1,
  "readingId": 2,
  "recitationId": 3,
  "comparedWith": { "readingId": 1, "recitationId": 1, "wayId": 0 },
  "text": "بِسْمِ اللَّهِ …",
  "highlights": [
    { "start": …, "length": …, "type": "TwoRecitationDifference" }
  ],
  "words": [{ "start": 0, "wSequenceId": 1, … }]
}
قراءات
١٠
قراءات
رواية
٢٠
رواية
سورة
١١٤
سورة
طرق لعدّ الآي
٦
طرق لعدّ الآي

كل ما تحتاجه القراءة، بيانات جاهزة

المحرّك نفسه الذي يعمل به عارض القراءات على quran.iilm.io، متاحٌ لتطبيقاتك.

نص مركّب لكل رواية

أي سورة بأي رواية من الروايات العشرين، بعلامات الوقف والسجدة والأرباع وأرقام الآيات، وفق طريقة العدّ التي تختارها.

مواضع الاختلاف مميَّزة

قارن برواية حفص أو بأي رواية أخرى، واعرض كلمات الفرش ومواضع الاختلاف بين القراءات والاختلاف مع العدّ الكوفي، وكلٌّ منها يصلك مقطعًا تنسّقه كما تشاء.

قراءات الكلمة الواحدة

اختر كلمة واحصل على ما تقرؤه كل رواية في موضعها، مجمّعةً حسب اللفظ المشترك.

النصوص المصاحبة

التفسير والترجمة وغيرهما من النصوص، على مستوى السورة أو الآية أو موضع الكلمة.

خدمات للبحث العلمي

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

معايير مفتوحة وأمان

مصادقة OAuth 2.0، ووثيقة OpenAPI 3، ورسائل أخطاء وفق RFC 9457، وحدود استخدام لكل تطبيق.

ثلاث خطوات إلى أول طلب

  1. ١

    سجّل تطبيقك

    أنشئ تطبيقًا في بوابة المطورين. يحصل تطبيق الخادم على معرّف (client_id) ومفتاح سري (client_secret) يُعرض مرة واحدة، فاحفظه على خادمك.

    افتح بوابة المطورين
  2. ٢

    احصل على رمز الدخول

    أرسل بياناتك إلى ‎/connect/token مع grant_type=client_credentials وscope=quran.read. الرمز صالح ٦٠ دقيقة، فأعد استخدامه حتى تنتهي صلاحيته.

  3. ٣

    استدعِ الواجهة

    أرسل الرمز في الترويسة Authorization: Bearer <token> إلى أي خدمة تحت ‎/api/v1، وكل الاستجابات بصيغة JSON.

    تصفّح الخدمات

انسخ، الصق، شغّل

سورة الفاتحة برواية ورش، مع تمييز الكلمات المخالفة لرواية حفص.

# 1. Get an access token (valid for 60 minutes)
curl -s -X POST https://quran-api.iilm.io/connect/token \
  -d grant_type=client_credentials \
  -d client_id=YOUR_CLIENT_ID \
  -d client_secret=YOUR_CLIENT_SECRET \
  -d scope=quran.read

# 2. Al-Fatiha in Warsh, with the differences from Hafs highlighted
curl -s "https://quran-api.iilm.io/api/v1/chapters/1/text?readingId=2&recitationId=3&countingId=1&compareWithHafs=true" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

احفظ المفتاح السري على الخادم، ولا تضعه أبدًا في صفحة ويب أو تطبيق جوال.

خدمات القراءة

تتطلب جميعها النطاق quran.read. كل المعاملات والاستجابات موثّقة، مع واجهة لتجربة الطلبات مباشرة.

كل المعاملات في التوثيق

الفهارس

النص

النصوص المصاحبة

البحث والإحصاء

اختر طريقة المصادقة المناسبة لتطبيقك

الخوادم والأنظمة الخلفية

Client credentials

  • تطبيق سري له معرّف (client_id) ومفتاح سري (client_secret)
  • النطاق quran.read: قراءة كل المحتوى دون تسجيل دخول مستخدم
  • الأنسب للمواقع التي تُبنى صفحاتها على الخادم والروبوتات ومعالجة البيانات

تطبيقات يسجّل فيها المستخدمون الدخول

Authorization code + PKCE

  • تطبيق عام بعناوين عودة مسجّلة ودون مفتاح سري
  • يسجّل المستخدم الدخول على صفحة الواجهة، وتُمنح النطاقات حسب دوره
  • الأنسب لتطبيقات الجوال وتطبيقات الويب أحادية الصفحة
رموز الدخول
JWT، صالحة ٦٠ دقيقة
رموز التجديد
١٤ يومًا (مع تسجيل الدخول)
حد الاستخدام
٦٠٠ طلب في الدقيقة لكل تطبيق
الأخطاء
وفق RFC 9457
وثيقة اكتشاف OAuth

أسئلة شائعة

كيف أحصل على صلاحية الوصول؟

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

ما القراءات والروايات المتاحة؟

القراءات العشر بروايتين لكل قراءة (عشرون رواية)، وجميع السور الـ١١٤، وست طرق لعدّ الآي. تعرض الخدمتان ‎/api/v1/readings و‎/api/v1/recitations المعرّفات التي تستخدمها بقية الخدمات.

هل يمكن استدعاء الواجهة من المتصفح أو من تطبيق جوال؟

نعم، لكن دون مفتاح سري أبدًا. إما أن تسجّل تطبيقًا عامًا يسجّل فيه المستخدمون الدخول بطريقة authorization code مع PKCE، وإما أن تستدعي الواجهة من خادمك وتمرّر النتائج.

ما حدود الاستخدام؟

٦٠٠ طلب في الدقيقة لكل تطبيق، و٣٠ طلبًا في الدقيقة لكل عنوان IP على خدمة الرموز، وعند تجاوزها تعيد الواجهة الرمز 429. أعد استخدام الرمز طوال صلاحيته (٦٠ دقيقة)، واحفظ نصوص السور مؤقتًا لمدة ٥ دقائق كما تسمح الواجهة.

كيف أستخدم التظليلات ومواضع الكلمات؟

لكل تظليل بداية وطول ونوع، محسوبة بوحدات UTF-16، وهي فهارس النصوص في JavaScript وJava وC# وNSString في Swift. نسّق هذه المقاطع كما تريد، واستخدم مواضع الكلمات لطلب قراءات الكلمة التي يضغط عليها المستخدم.

هل توجد وثيقة OpenAPI؟

نعم، على العنوان ‎/openapi/v1.json في الواجهة. استوردها في Postman أو Insomnia، أو ولّد منها عميلًا جاهزًا بلغتك البرمجية.

تبني مشروعًا مع القرآن الكريم؟

للأسئلة وطلبات الوصول والشراكات، أو إن احتجت قراءة غير متاحة: راسلنا.

[email protected] احصل على مفتاح