Using Prayer Times — Ali Web Services

Overviewنظرة عامة

What it doesما الذي تفعله

You give it a latitude, a longitude, an IANA time zone and a month. It returns the five prayer times for every day in that month, plus sunrise, in the zone you named.تعطيها خط عرض وخط طول ومنطقة زمنية بصيغة IANA وشهراً، فتعيد مواقيت الصلوات الخمس لكل يوم في ذلك الشهر، ومعها الشروق، بحسب المنطقة الزمنية التي حدّدتها.

The calculation is astronomy — a solar position and a convention for the twilight angle. That is why there is nothing to license, nothing to keep fresh and nothing that can go stale.الحساب فَلَك: موضع الشمس واصطلاح لزاوية الشفق. ولهذا لا يوجد ما يُرخَّص، ولا ما يحتاج تحديثاً، ولا ما يمكن أن يتقادم.

The response always says which convention it used. The server states its truth and your surface phrases it — you never have to guess which method produced a number.تذكر الاستجابة دائماً الاصطلاح الذي استُخدم. الخادم يذكر حقيقته وواجهتك تصوغها — فلن تضطر أبداً إلى تخمين الطريقة التي أنتجت رقماً ما.

Using itالاستخدام

One endpointنقطة نهاية واحدة

A single GET. Everything is a query parameter, and there is no key to send.طلب GET واحد. كل شيء يُمرَّر كمعامل استعلام، ولا يوجد مفتاح تُرسله.

curl 'https://prayer.ali-web-services.com/v1/times?lat=24.7136&lng=46.6753&tz=Asia/Riyadh&month=2026-09'

Parametersالمعاملات

Parameterالمعامل	Meaningالمعنى
lat	Latitude, −90 to 90. Required.خط العرض، من −٩٠ إلى ٩٠. مطلوب.
lng	Longitude, −180 to 180. Required.خط الطول، من −١٨٠ إلى ١٨٠. مطلوب.
tz	An IANA zone name such as `Asia/Riyadh`. Required — it is never guessed.اسم منطقة زمنية بصيغة IANA مثل `Asia/Riyadh`. مطلوب — ولا يُخمَّن أبداً.
month	`YYYY-MM`. Defaults to the current month in the zone you gave.`YYYY-MM`. وإن أُغفل فالشهر الحالي في المنطقة الزمنية التي حدّدتها.
method	`umm-al-qura` (default) or `mwl`.`umm-al-qura` (الافتراضي) أو `mwl`.
school	`standard` (default) or `hanafi`, which changes Asr only.`standard` (الافتراضي) أو `hanafi`، ولا يغيّر إلا العصر.

The responseالاستجابة

{
  "month": "2026-09",
  "lat": 24.7136,
  "lng": 46.6753,
  "timezone": "Asia/Riyadh",
  "method": "umm-al-qura",
  "school": "standard",
  "note": "Calculated from the sun's position, not the Adhan announced by any particular mosque.",
  "days": [
    {
      "date": "2026-09-01",
      "fajr": "04:14",
      "sunrise": "05:34",
      "dhuhr": "11:53",
      "asr": "15:22",
      "maghrib": "18:12",
      "isha": "19:42"
    }
  ]
}

Times are HH:MM in the zone you asked for, so a client indexes the table by date rather than deciding for itself when a day begins.المواقيت بصيغة HH:MM في المنطقة الزمنية التي طلبتها، فيفهرس العميل الجدول بالتاريخ بدل أن يقرّر بنفسه متى يبدأ اليوم.

Conventionsالاصطلاحات

The convention is a decision, not a detailالاصطلاح قرار لا تفصيلة

Method and school change the answer. Umm al-Qura is the standard in Saudi Arabia and much of the Gulf — Fajr at 18.5° below the horizon, and Isha ninety minutes after Maghrib, extended to two hours during Ramadan.الطريقة والمذهب يغيّران الإجابة. أم القرى هي المعتمدة في السعودية وكثير من دول الخليج — الفجر عند ١٨٫٥ درجة تحت الأفق، والعشاء بعد المغرب بتسعين دقيقة، تُمدّ إلى ساعتين في رمضان.

An unknown method or school is refused rather than quietly replaced with the default. Falling back would answer a question nobody asked, with times that look right and follow the wrong convention.تُرفض أي طريقة أو مذهب غير معروف بدل استبدالهما بالافتراضي بصمت. فالرجوع إلى الافتراضي يجيب عن سؤال لم يطرحه أحد، بمواقيت تبدو صحيحة وتتبع اصطلاحاً خاطئاً.

Ramadan is something you declare, because knowing the Hijri month requires the Umm al-Qura table and that is a separate question about redistribution. Guessing the month with arithmetic would put a plausible wrong answer inside a religious observance.رمضان أمر تُصرّح به أنت، لأن معرفة الشهر الهجري تتطلب جدول أم القرى وتلك مسألة منفصلة تتعلق بإعادة النشر. وتخمين الشهر حسابياً يضع إجابة خاطئة مقبولة الظاهر داخل عبادة.

The claimحدود ما نقول

These are calculated timesهذه مواقيت محسوبة

These times are calculated from the position of the sun. They are not the Adhan announced by any particular mosque, and in Saudi Arabia the announced Adhan is what people act on. Every response repeats this in its note field, so the caveat travels with the data rather than living only on this page.هذه المواقيت محسوبة من موضع الشمس. وهي ليست الأذان الذي يُرفع في مسجد بعينه، وفي السعودية الأذان المرفوع هو ما يعمل الناس به. وتكرّر كل استجابة هذا في حقل note، فيسافر التنبيه مع البيانات بدل أن يبقى على هذه الصفحة وحدها.

Show it. A prayer-times widget that presents a computed number as though it were the call to prayer is making a claim the arithmetic cannot support.أظهِره. فأي أداة تعرض رقماً محسوباً كأنه النداء إلى الصلاة إنما تدّعي ما لا يسنده الحساب.

Edge casesالحالات الطرفية

When a prayer has no timeحين لا يكون للصلاة وقت

Far enough north or south, a summer night never gets dark enough for Fajr or Isha to have a solar definition at all. Those days are named in an absent list rather than left as empty fields.في خطوط العرض العالية شمالاً أو جنوباً، لا يُظلم ليل الصيف بما يكفي ليكون للفجر أو العشاء تعريف شمسي أصلاً. وتُسمّى تلك الأيام في قائمة absent بدل تركها حقولاً فارغة.

A caller who does not know this reads a gap as a defect. Naming it is the difference between "there is no such time" and "something went wrong".من لا يعرف هذا يقرأ الفراغ على أنه خلل. وتسميتها هي الفرق بين «لا وجود لهذا الوقت» و«حدث خطأ ما».

Limitsالحدود

Open, and cheap to be kind toمفتوحة، ومن السهل الرفق بها

There is no key and no sign-up. Every response carries a day of cache, and asking for a month rather than a day is what keeps this cheap for both of us — one request a month per location is the shape the service is built for.لا مفتاح ولا تسجيل. وتحمل كل استجابة تخزيناً مؤقتاً ليوم كامل، وطلب شهر بدل يوم هو ما يبقي التكلفة زهيدة لكلينا — طلب واحد شهرياً لكل موقع هو الشكل الذي بُنيت الخدمة من أجله.

Cross-origin requests are allowed from anywhere. There is no key that could leak into page JavaScript, so a browser widget is a first-class way to use this.الطلبات من أصول أخرى مسموحة من أي مكان. ولا يوجد مفتاح يمكن أن يتسرّب إلى جافاسكربت الصفحة، فأداة المتصفح طريقة أصيلة لاستخدام هذه الخدمة.

Privacyالخصوصية

Asking for times leaves nothing behindطلب المواقيت لا يترك أثراً

There is no datastore of any kind. A coordinate arrives, a table is computed and returned, and nothing about the request is written down.لا يوجد مخزن بيانات من أي نوع. تصل الإحداثية، ويُحسب الجدول ويُعاد، ولا يُدوَّن شيء عن الطلب.

A coordinate can be a home. That is exactly why a service like this should hold none of them, and holding nothing is easier to keep true than a retention policy is.قد تكون الإحداثية منزلاً. ولهذا بالضبط ينبغي لخدمة كهذه ألا تحتفظ بأي منها، والاحتفاظ بلا شيء أسهل في الصون من أي سياسة استبقاء.

Why hereلماذا من هنا

Built in Saudi Arabiaبُنيت في السعودية

The regionally correct default is also the one we would have picked anyway, and the guide reads the same in Arabic as it does in English — right to left, in a typeface that carries both scripts properly.الافتراضي الصحيح إقليمياً هو نفسه ما كنا سنختاره على أي حال، ويُقرأ هذا الدليل بالعربية كما يُقرأ بالإنجليزية — من اليمين إلى اليسار، بخط يحمل الكتابتين كما ينبغي.