منصة المطورين
منصة المطورين
واجهات JSON عامة لمواقيت الصلاة والقبلة والتاريخ الهجري وبيانات القرآن المرجعية، مع مختبر تفاعلي يجرّب كل طلب مباشرة من هذه الصفحة.
بدون مفاتيح أو تسجيل
كل الواجهات العامة مفتوحة للقراءة عبر GET، ولا تحتاج حساباً ولا رمز وصول.
CORS مفتوح
تستطيع النداء مباشرة من المتصفح: الرأس access-control-allow-origin مضبوط على *.
استجابات مخزَّنة
المواقيت تُخزَّن 5 دقائق، والقبلة والتحويل الهجري 24 ساعة، وبيانات القرآن طويلة الأمد.
استخدام عادل
لا حد صارم حالياً، والمتوقع أقل من 60 طلباً في الدقيقة لكل عميل مع احترام التخزين المؤقت.
https://wesalna.com/api/publicالمختبر التفاعلي
اختر واجهة، عدّل المعاملات، ثم أرسل الطلب فعلياً وشاهد الاستجابة الحقيقية وزمنها وحجمها.
مواقيت الصلاة
حساب فلكي دقيق لمواقيت اليوم بالإحداثيات أو بمعرّف مدينة مدعومة، مع الإمساك ومنتصف الليل والثلث الأخير والتاريخ الهجري وزاوية القبلة.
من -90 إلى 90. مطلوب إن لم تُرسل city.
من -180 إلى 180. مطلوب إن لم تُرسل city.
معرّف مدينة مدعومة مثل makkah بديلا عن الإحداثيات، ويضبط أيضا المنطقة الزمنية وطريقة الحساب. القائمة في /api/public/cities.
بصيغة YYYY-MM-DD، والافتراضي اليوم.
إحدى الطرق المعتمدة.
standard للجمهور، وhanafi للحنفية.
معرّف IANA مثل Asia/Amman لعرض الوقت المحلي.
GET https://wesalna.com/api/public/prayer-times?lat=31.9539&lng=35.9106&method=MuslimWorldLeague&madhhab=standard&timezone=Asia%2FAmmanالاستجابة
لم تُرسل أي طلب بعد. اضغط "أرسل الطلب" لرؤية استجابة حقيقية من الخدمة.
أمثلة الكود
curl -s "https://wesalna.com/api/public/prayer-times?lat=31.9539&lng=35.9106&method=MuslimWorldLeague&madhhab=standard&timezone=Asia%2FAmman"حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
times.<prayer>.utc | string | وقت الصلاة بصيغة ISO 8601 بتوقيت UTC. |
times.<prayer>.local | string | الوقت بصيغة HH:mm في المنطقة الزمنية المطلوبة. |
extras.imsak | midnight | lastThird | object | أوقات مساندة للصيام والقيام. |
date.hijri | object | اليوم والشهر والسنة الهجرية مع اسم الشهر بالعربية والإنجليزية. |
qibla.bearing | number | زاوية القبلة بالدرجات من الشمال الحقيقي. |
city | object | بيانات المدينة وروابط صفحتها بالعربية والإنجليزية، تظهر عند إرسال city. |
تخزين مؤقت 5 دقائق.
الأخطاء ومعالجتها
كل خطأ يعود بصيغة JSON ثابتة تحتوي error.status وerror.message وغالباً error.hint يشرح الإصلاح.
| الرمز | المعنى |
|---|---|
400 | معامل ناقص أو غير قابل للقراءة (مثل lat غير رقمي). |
404 | المورد غير موجود، مثل سورة غير معروفة. |
422 | قيمة صحيحة الشكل لكن خارج النطاق أو غير مدعومة. |
500 | خطأ غير متوقع في الخدمة؛ أعد المحاولة لاحقاً. |
مثال خطأ
{
"ok": false,
"error": {
"status": 422,
"message": "Coordinates out of range.",
"hint": "lat must be -90..90 and lng must be -180..180."
}
}تضمين ودجت المواقيت
إن أردت واجهة جاهزة بدل بناء واحدة، ضمّن ودجت المواقيت في صفحتك عبر iframe واحد.
<iframe
src="https://wesalna.com/embed/prayer"
title="Wesalna prayer times"
width="100%"
height="360"
style="border:0;border-radius:16px"
></iframe>شروط الاستخدام: أبقِ نسبة الإحداثيات والحسابات كما تعود من الخدمة دون تعديل يُغيّر المعنى الشرعي، وأضف إشارة إلى وصالنا كمصدر البيانات.
ماذا يمكنك بناؤه اليوم، وما الذي نعمل عليه
هذه الصفحة موجّهة لمن يريد إدخال المواقيت أو بيانات القرآن في موقعه أو تطبيقه. نفصّل هنا ما هو متاح الآن وما هو قيد التطوير، دون وعود غير مؤكدة.
متاح الآن
- إطار مواقيت الصلاة: كود جاهز للنسخ من صفحة التضمين، مع اختيار المدينة وطريقة الحساب والمظهر، ويتحدث تلقائياً كل يوم.
- صور مشاركة السور: مسار عام يولّد بطاقة SVG لكل سورة بالرسم العثماني، يستخدمه الموقع نفسه في بطاقات المشاركة.
- روابط عميقة مستقرة: مسارات مثل /quran/al-baqarah و/prayer-times و/qibla تصلح للربط المباشر من تطبيقك، وتدعم اللغتين عبر بادئة /en.
قيد التطوير
واجهات JSON للمواقيت والقبلة والتحويل الهجري وبيانات السور. نطوّرها مع ضبط حدود المعدل والتوثيق قبل الإعلان، ونفضّل تأخير الإصدار على نشر واجهة غير مستقرة تكسر تطبيقات الناس.
قواعد الاستخدام العادل
- لا ترسل طلبات آلية مكثفة؛ خزّن النتائج مؤقتاً على خادمك بدل تكرار الطلب لكل زائر.
- احتفظ بالإشارة إلى المصدر حيث تعرض بياناتنا.
- لا تنسب إلينا فتوى أو تفسيراً لم ننشره.
- راجع شروط الاستخدام قبل أي استخدام تجاري.
للاستفسار عن حالة واجهة أو طلب أولوية لميزة، راسلنا من صفحة التواصل.
أسئلة شائعة