اوقات شرعی
محاسبات جعفری (شیعی) برای هر نقطهٔ زمین — روشهای آماده، چند روش همزمان، یا زوایای کاملاً سفارشی؛ یک روز، یک ماه یا یک سال کامل در هر درخواست. عرضهای جغرافیایی بالا با قاعدهٔ TwilightAngle مدیریت میشود و نیمهشب شرعی میانهٔ غروب تا اذان صبح است.
GET https://theshia.org/api/v1/prayer-times
پارامترها
-
latrequired* latitude, -90 to 90 (decimal degrees, rounded to 2 dp for caching). *Not needed when city is given. -
lngrequired* longitude, -180 to 180 (2 dp). *Not needed when city is given. -
cityoptional city id from /cities (e.g. london, tehran, karbala) — sets lat, lng and tz automatically and overrides them. -
methoddefault: Tehran preset id (full value table under Calculation methods) · comma list "Tehran,Jafari" · "all" (all 16) · "custom" (with the angle parameters below). -
fajrAnglecustom only Fajr sun-depression angle, 4 to 24 degrees. Required when method=custom. -
ishaAnglecustom only Isha angle, 4 to 24 degrees. Give this OR ishaInterval. -
ishaIntervalcustom only Isha as minutes after maghrib, 0 to 180. Alternative to ishaAngle. -
maghribAnglecustom only Maghrib sun-depression angle, 0.5 to 12 degrees (Shia methods typically 4–4.5). -
maghribIntervalcustom only Maghrib as minutes after sunset, 0 to 120. Alternative to maghribAngle. -
dateoptional a single day, YYYY-MM-DD. -
monthdefault: current 1 to 12, combined with year. Ignored when date is given. -
yeardefault: current 1900 to 2100. Given ALONE (no month/date) = the full year, single method only. -
tzoptional 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 محدودند؛ درخواستهای بیش از ۴۹۶ محاسبهٔ روز×روش رد میشوند. برای استفادهٔ اجتماعی رایگان است، بدون تضمین دسترسپذیری.