مواقيت الصلاة

حسابات جعفرية (شيعية) لأي موقع على الأرض — طرق جاهزة، أو عدة طرق معاً، أو زوايا مخصصة بالكامل؛ يوم أو شهر أو سنة كاملة في الطلب الواحد. تُعالج خطوط العرض العالية بقاعدة TwilightAngle، ومنتصف الليل الشرعي هو منتصف ما بين الغروب والفجر الصادق.

GET https://theshia.org/api/v1/prayer-times

المعاملات

lat required* latitude, -90 to 90 (decimal degrees, rounded to 2 dp for caching). *Not needed when city is given.
lng required* longitude, -180 to 180 (2 dp). *Not needed when city is given.
city optional city id from /cities (e.g. london, tehran, karbala) — sets lat, lng and tz automatically and overrides them.
method default: Tehran preset id (full value table under Calculation methods) · comma list "Tehran,Jafari" · "all" (all 16) · "custom" (with the angle parameters below).
fajrAngle custom only Fajr sun-depression angle, 4 to 24 degrees. Required when method=custom.
ishaAngle custom only Isha angle, 4 to 24 degrees. Give this OR ishaInterval.
ishaInterval custom only Isha as minutes after maghrib, 0 to 180. Alternative to ishaAngle.
maghribAngle custom only Maghrib sun-depression angle, 0.5 to 12 degrees (Shia methods typically 4–4.5).
maghribInterval custom only Maghrib as minutes after sunset, 0 to 120. Alternative to maghribAngle.
date optional a single day, YYYY-MM-DD.
month default: current 1 to 12, combined with year. Ignored when date is given.
year default: current 1900 to 2100. Given ALONE (no month/date) = the full year, single method only.
tz optional IANA timezone (e.g. Europe/London) — adds local HH:mm strings next to the UTC instants. Auto-filled from city.

Budget: days × methods per request must be ≤ 496 (a month allows all 16 methods; a year allows one).
Response: meta { lat, lng, city?, tz, qibla, method? } and per day: date + imsak, fajr, sunrise, dhuhr, asr, sunset, maghrib, isha, midnight as ISO 8601 UTC instants (+ local { … } when tz is set). Multiple methods return results: [ { method, days } ].
Always applied: TwilightAngle high-latitude rule; imsak = fajr − 10 min; midnight = midpoint of maghrib and the next day's fajr.

افتح مثالاً حياً ↗

أمثلة برمجية

curl

curl "https://theshia.org/api/v1/prayer-times?city=london&method=Tehran&year=2026&month=7"

JavaScript

const res = await fetch("https://theshia.org/api/v1/prayer-times?city=london&method=Tehran&year=2026&month=7");
const data = await res.json();

Python

import requests

data = requests.get("https://theshia.org/api/v1/prayer-times?city=london&method=Tehran&year=2026&month=7").json()

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

الاستجابات مخزنة بقوة على الحافة — يرجى التخزين من جهتكم أيضاً. الطلبات غير المخزنة محدودة بـ١٠٠ في الدقيقة لكل IP؛ والطلبات الضخمة (أكثر من ٤٩٦ حسابَ يوم×طريقة) تُرفض. مجاني للاستخدام المجتمعي، بلا ضمان توافر.