API V1.3 · آخر تحديث 2026-09-12

QuranReels Developers: API عربية للقرآن والأدوات الإسلامية

بوابة مطورين لاستخدام بيانات QuranReels المنشورة في التطبيقات والأتمتة. توفر 29 عملية API للقرآن والأذكار والتلاوات ومخارج الحروف والأسماء وإذاعة القرآن وتحليل المكونات، بعقود مستقرة ومفاتيح قابلة للإلغاء.

ابدأ بأول طلب OpenAPI 3.1.1 مستكشف API

ما هي QuranReels Developers؟

واجهة API موثقة لمحتوى وبيانات الأدوات الإسلامية المنشورة في QuranReels، وليست مجرد قائمة روابط أو نموذج تجريبي.

ما الذي يمكن ربطه؟

يمكن للتطبيقات وتدفقات n8n قراءة آيات القرآن والأذكار والتلاوات والمخارج والأسماء والمحطات، أو طلب تحليل نص مكونات ضمن الحصص المعلنة.

كيف أعرف مصدر النتيجة؟

الاستجابات الدينية تعرض حقل trust بالمصدر والإصدار وحالة المراجعة المسجلة فعليًا؛ لا ننشئ اعتمادًا أو مراجعة غير موجودة.

كيف تستخدم QuranReels API؟

اطلب مشروعًا ومفتاح API من مالك الموقع.
احفظ المفتاح في متغير بيئة أو Credential آمن.
أرسله في ترويسة Authorization: Bearer فقط.

curl -H 'Authorization: Bearer $QURANREELS_API_KEY' \
  'https://quranreels.tech/api/v1/adhkar?collection=adhkar&category=morning&per_page=5'

لا تضع المفتاح أو نصوص مكوّنات المنتجات في رابط أو query string أو JavaScript عام.

واجهات API الإسلامية المتاحة

المسارات المعلنة هي فقط التي تعمل فعليًا. كل عملية تتطلب مفتاحًا وصلاحية مناسبة؛ لا تُعرض واجهة كأنها متاحة قبل تنفيذها واختبارها.

القرآن / Quran

114 سورة و6,236 آية وبحث ونطاقات محلية

quran:read

مصادر البيانات / Datasets

الإصدار والبصمة والمصدر لكل حزمة

catalog:read

الأذكار / Adhkar

فئات وبحث وقراءة عنصر

adhkar:read

مخارج الحروف / Makharij

حروف ومخارج ومقارنة

makharij:read

التلاوات / Recitations

بحث وفلاتر وروابط استماع

recitations:read

الأسماء / Names

بحث بالاسم والمعنى والأصل

names:read

إذاعة القرآن / Radio

محطات وبحث وروابط بث

radio:read

كاشف الحلال / Halal

تحليل نص المكونات بالأسباب

halal:analyze

Method	Endpoint	Scope
`GET`	`/api/v1/tools`	`catalog:read`
`GET`	`/api/v1/tools/{tool_id}`	`catalog:read`
`GET`	`/api/v1/datasets`	`catalog:read`
`GET`	`/api/v1/datasets/{dataset_id}`	`catalog:read`
`GET`	`/api/v1/quran/surahs`	`quran:read`
`GET`	`/api/v1/quran/surahs/{surah_id}`	`quran:read`
`GET`	`/api/v1/quran/verses/{surah_id}/{ayah}`	`quran:read`
`GET`	`/api/v1/quran/range`	`quran:read`
`GET`	`/api/v1/quran/search`	`quran:read`
`GET`	`/api/v1/adhkar/categories`	`adhkar:read`
`GET`	`/api/v1/adhkar`	`adhkar:read`
`GET`	`/api/v1/adhkar/random`	`adhkar:read`
`GET`	`/api/v1/adhkar/{dhikr_id}`	`adhkar:read`
`GET`	`/api/v1/makharij/letters`	`makharij:read`
`GET`	`/api/v1/makharij/letters/{letter_id}`	`makharij:read`
`GET`	`/api/v1/makharij/points`	`makharij:read`
`GET`	`/api/v1/makharij/compare`	`makharij:read`
`GET`	`/api/v1/recitations`	`recitations:read`
`GET`	`/api/v1/recitations/{recitation_id}`	`recitations:read`
`GET`	`/api/v1/names`	`names:read`
`GET`	`/api/v1/names/{name_id}`	`names:read`
`GET`	`/api/v1/radio/stations`	`radio:read`
`GET`	`/api/v1/radio/stations/{station_id}`	`radio:read`
`POST`	`/api/v1/halal/analyze`	`halal:analyze`
`GET`	`/api/v1/halal/knowledge/version`	`halal:analyze`
`GET`	`/api/v1/halal/ingredients/{ingredient_id}`	`halal:analyze`
`POST`	`/api/v1/halal/analyze/batch`	`halal:analyze`
`GET`	`/api/v1/halal/analyze/batch/{job_id}`	`halal:analyze`
`GET`	`/api/v1/account/usage`	`authenticated`

شكل الاستجابة والأخطاء

{"data":[...],"pagination":{"page":1,"per_page":25,"total":31,"has_more":true},"data_version":"2026-09-12.2"}

الأخطاء تحمل code ثابتًا وrequest_id. عند 429 اتبع Retry-After، وعند 503 أعد المحاولة لاحقًا.

منهج الثقة وحدود البيانات

المصدر والإصدار

تتضمن الاستجابات الدينية حقل trust يوضح المصدر وإصدار البيانات والبصمة عندما تكون البصمة مطابقة لكل البيانات المعادة.

المراجعة كما هي

حالة المراجعة المعادة هي المسجلة فعليًا. لا تضيف QuranReels اسم مراجع أو اعتمادًا شرعيًا غير موثق.

الحلال ليس شهادة

تحليل المكونات يعرض الأدلة والمطابقات والنفي والمواد غير المعروفة، لكنه لا يمنح شهادة حلال ولا يستبدل التحقق الرسمي.

تتوفر بيانات القرآن والأذكار والتلاوات ومخارج الحروف والأسماء والإذاعة والتحليل الغذائي. لا توفر API بيانات مستخدمين، ولا توليد فيديو، ولا سجل عبادة شخصي.

استخدامات عملية مناسبة

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

مصادر QuranReels ذات الصلة

الأسئلة الشائعة للمطورين

هل QuranReels API مجانية؟

الـAPI متاحة بمفتاح يصدره مالك الموقع. الحد الافتراضي 1,000 طلب يوميًا و30 طلبًا بالدقيقة لكل مطور عبر مشروعاته، ويمكن تعديل الحصة ضمن سقوف الحماية.

هل أحتاج مفتاح API؟

نعم. توثيق OpenAPI والصفحات العامة متاحان للقراءة، لكن كل مسار بيانات تحت /api/v1 يتطلب مفتاح Bearer وصلاحية مناسبة.

هل توفر API فتوى أو شهادة حلال؟

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

كيف أتحقق من مصدر أو مراجعة المحتوى؟

اقرأ حقل trust في الاستجابة: يعرض المصدر وإصدار البيانات وحالة المراجعة والمراجع عندما تكون مسجلة. غياب مراجع مؤهل لا يُعرض كاعتماد.

هل يمكنني أتمتة الإرسال إلى WhatsApp أو Telegram؟

QuranReels يوفر البيانات وتجهيز النتيجة. أنت تربط الإرسال والجدولة من بيئتك عبر n8n أو خدمتك بعد الالتزام بسياسات تلك الخدمة وموافقة المستلمين.

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

الحد الافتراضي هو 1,000 طلب يوميًا و30 طلبًا بالدقيقة للمطور عبر كل مشروعاته. تحليل الحلال له سقف منفصل لحماية الخدمة، والدفعة غير المتزامنة تدعم من 1 إلى 20 عنصرًا.