واجهة برمجة مواقيت الصلاة المجانية دون مفتاح API
واجهة مواقيت صلاة مجانية دون مفتاح أو تسجيل. احصل على المواقيت اليومية بصيغة JSON بخط العرض والطول، مع خلاصة iCal وبحث المدن والمساجد القريبة.
في هذه الصفحة
واجهة مواقيت الصلاة على qurangallery.com/prayer/developers مجانية ولا تحتاج إلى مفتاح API ولا تسجيل. وفيها أربع نقاط نهاية عامة: مواقيت الصلاة اليومية بصيغة JSON لخط عرض وخط طول، وخلاصة iCal قابلة للاشتراك، وبحث المدن، والمساجد القريبة.
كل نقاط النهاية تحت https://qurangallery.com/prayer. المدخلات الخاطئة تعيد 400، وكثرة الطلبات تعيد 429.
مواقيت الصلاة لموقع
تعيد GET /api/times فجر اليوم والشروق والظهر والعصر والمغرب والعشاء لزوج من الإحداثيات، مع فجر الغد. كل وقت لحظة بصيغة ISO 8601 بالتوقيت العالمي UTC. والوقت غير الموجود عند ذلك الخط في ذلك اليوم يُسقَط.
curl 'https://qurangallery.com/prayer/api/times?lat=21.4225&lng=39.8262'المعاملات:
lat— مطلوب. خط العرض بالدرجات العشرية.lng— مطلوب. خط الطول بالدرجات العشرية.method— اختياري. معرّف طريقة الحساب، مثل mwl وisna وkarachi. الافتراضي: طريقة أقرب مدينة.asr— اختياري. standard أو hanafi، وهو يحدد وقت العصر. الافتراضي: العُرف المعتاد في بلد أقرب مدينة.hlr— اختياري. قاعدة خطوط العرض العليا: auto أو middle-of-the-night أو seventh-of-the-night أو twilight-angle. الافتراضي: auto.faوia— اختياريان. زاويتا الفجر والعشاء المخصصتان بالدرجات، من 10 إلى 25. الافتراضي: زاوية الطريقة نفسها.
الاستجابة، مختصرة:
{
"date": "2026-10-31",
"times": [
{ "name": "fajr", "time": "2026-10-31T02:06:00.000Z", "isCurrent": false, "isNext": true },
{ "name": "sunrise", "time": "2026-10-31T03:23:00.000Z", "isCurrent": false, "isNext": false },
{ "name": "dhuhr", "time": "2026-10-31T09:04:00.000Z", "isCurrent": false, "isNext": false },
{ "name": "asr", "time": "2026-10-31T12:20:00.000Z", "isCurrent": false, "isNext": false },
{ "name": "maghrib", "time": "2026-10-31T14:45:00.000Z", "isCurrent": false, "isNext": false },
{ "name": "isha", "time": "2026-10-31T16:15:00.000Z", "isCurrent": false, "isNext": false }
],
"fajrTomorrow": "2026-11-01T02:06:00.000Z"
}التاريخ هو يوم الإحداثيات المحلي نفسه. ولا يوجد حد خاص بمواقيت الصلاة، فخزّن إجابة كل موقع طوال اليوم بدل الاستدعاء عند كل عرض للصفحة.
بحث المدن
تحوّل GET /api/location/search اسم مكان إلى إحداثيات ورمز بلد ومنطقة زمنية. وتبحث أولًا في قائمة مدن التطبيق نفسه، والاستعلام الذي لا يطابق شيئًا يعيد مصفوفة فارغة.
curl 'https://qurangallery.com/prayer/api/location/search?q=Makkah'q— مطلوب. اسم المكان، بحد أقصى 200 حرف.
[
{
"lat": 21.4266,
"lon": 39.8256,
"displayName": "Makkah, Saudi Arabia",
"countryCode": "SA",
"timezone": "Asia/Riyadh"
}
]خذ lat وlon من أول نتيجة ومرّرهما بصفة lat وlng إلى نقطة نهاية مواقيت الصلاة.
خلاصة التقويم (iCal)
تعيد GET /api/calendar/feed.ics ملف text/calendar قابلًا للاشتراك فيه، فيه مواقيت الصلاة والمناسبات الإسلامية، لشهر واحد افتراضيًا وحتى 12 شهرًا. أضف رابطه اشتراكًا في تقويم Google أو تقويم Apple أو Outlook.
curl 'https://qurangallery.com/prayer/api/calendar/feed.ics?lat=21.4225&lng=39.8262'المطلوب: lat وlng. والاختياري: method وasr وhlr وfa وia كما سبق، إضافة إلى:
authority— جهة التقويم الهجري للمناسبات، مثل umm_al_qura أو diyanet. الافتراضي: جهة بلد أقرب مدينة.months— عدد الأشهر التي تغطيها الخلاصة، من 1 إلى 12. الافتراضي: 1.alarm— الدقائق قبل كل صلاة للتنبيه، من 0 إلى 120. وتعني 0 بلا تنبيه. الافتراضي: 10.sunriseوtravelوramadanوjumuahوbusy— اجعلها 1 لتفعيل الشروق، أو ملاحظة السفر، أو مناسبات رمضان، أو الجمعة في أيام الجمعة، أو وقت الانشغال. الافتراضي: معطّلة.
ويمكنك أيضًا بناء الخلاصة نفسها دون كود من صفحة مزامنة التقويم. وتسمح خلاصة التقويم بـ30 طلبًا في الدقيقة.
المساجد القريبة
تعرض GET /api/mosques/nearby المساجد حول نقطة، الأقرب أولًا، من بيانات OpenStreetMap. والمسافة بالمتر. وتكون الإجابة 503 إذا تعذّرت خدمات بيانات الخرائط.
curl 'https://qurangallery.com/prayer/api/mosques/nearby?lat=21.4225&lng=39.8262&radius=2000'latوlng— مطلوبان.radius— اختياري. نصف قطر البحث بالمتر، من 100 إلى 50000. الافتراضي: 2000.
[
{
"id": 1234567,
"name": "Example Mosque",
"lat": 21.4231,
"lng": 39.8269,
"address": "Example Street 12",
"distance": 96.4
}
]تعتمد التغطية على OpenStreetMap. والعرض داخل التطبيق لهذه البيانات نفسها موصوف في صفحة المساجد.
حدود المعدّل
تُحسب الطلبات لكل عنوان IP في نافذة مدتها دقيقة. وبعد الحد تحصل على HTTP 429.
- مواقيت الصلاة: لا حد خاص بها.
- خلاصة التقويم: 30 طلبًا في الدقيقة.
- بحث المدن والمساجد القريبة يتقاسمان حصة واحدة: 30 طلبًا في الدقيقة.
الاستخدام من المتصفح
لا ترسل الواجهة ترويسات CORS، فلا تستطيع صفحة في موقع آخر قراءة الاستجابة. استدعِها من خادمك بدلًا من ذلك. وإن أردت فقط عرض المواقيت في موقع، فاستخدم ودجة الموقع: إطار iframe واحد، دون كود ودون مفتاح.
انظر أيضًا
- ودجة الموقع — مواقيت الصلاة أو التقويم الهجري بإطار iframe.
- طرق الحساب — ما الطريقة الافتراضية، والخيارات الأخرى.
- مزامنة التقويم — الخلاصة نفسها، تُبنى من نموذج.
الخطوات التالية
أسئلة
هل واجهة مواقيت الصلاة مجانية، وهل أحتاج إلى مفتاح API؟
نعم، هي مجانية ولا تحتاج إلى مفتاح ولا حساب ولا تسجيل. أرسل طلب GET إلى نقطة النهاية مع المعاملات، والتزم بحدود المعدّل.
كيف أحصل على مواقيت الصلاة لاسم مدينة؟
استدعِ نقطة نهاية بحث المدن بالمعامل q، وخذ lat وlon من أول نتيجة، ثم مرّرهما بصفة lat وlng إلى نقطة نهاية مواقيت الصلاة.
ما طريقة الحساب وقاعدة العصر التي تستخدمها الواجهة افتراضيًا؟
إن لم تُرسل method استخدمت طريقة أقرب مدينة إلى إحداثياتك. وإن لم تُرسل asr استخدمت عُرف العصر المعتاد في بلد تلك المدينة. أرسل الاثنين لتثبيتهما.
لماذا تغيب صلاة من الاستجابة؟
قرب القطبين قد لا تبلغ الشمس زاوية الفجر أو العشاء أبدًا، فلا يوجد وقت يُعطى. وتُسقط الواجهة تلك الصلاة بدل أن تعيد تاريخًا غير صالح.
هل يمكنني استدعاء الواجهة من JavaScript في المتصفح؟
لا ترسل الواجهة ترويسات CORS، فلا تستطيع صفحة في موقع آخر قراءة الاستجابة. استدعِها من خادمك، أو استخدم الودجة المضمَّنة التي لا تحتاج إلى كود.
ما حدود المعدّل؟
تُحسب الطلبات لكل عنوان IP في نافذة مدتها دقيقة. تسمح خلاصة التقويم بـ30 طلبًا في الدقيقة، ويتقاسم بحث المدن والمساجد القريبة حصة واحدة قدرها 30 في الدقيقة. وبعد الحد تحصل على HTTP 429.
كم مرة ينبغي أن أطلب مواقيت الصلاة؟
تكفي مرة لكل موقع في اليوم. احفظ الاستجابة واحسب العدّ التنازلي بنفسك؛ وفجر الغد مضمَّن لساعات ما بعد العشاء.
هل توجد خلاصة iCal؟
نعم. تعيد خلاصة التقويم ملف .ics قابلًا للاشتراك فيه، فيه مواقيت الصلاة والمناسبات الإسلامية، لشهر واحد افتراضيًا وحتى 12 شهرًا بالمعامل months.