یومی کیفیت
آج (یا کوئی تاریخ) مشین کے پڑھنے لائق فلیگز میں — ہجری تاریخ، دن کے مواقع اور سوگ/جشن، روزہ اور شبِ عبادت کے اشارے — تاکہ مسجد سائٹس اور ایپس خود بخود اپنا رنگ بدلیں۔
GET https://theshia.org/api/v1/day-status
پیرامیٹرز
-
datedefault: today the day to describe, YYYY-MM-DD (years 1900 to 2100). -
calendardefault: moonsighting values: "moonsighting" · "iran".
- Response: date, weekday, hijri { hy, hm, hd, monthName ×4 }, the day's events, and flags: mourning (the extended period 1 Muharram → 8 Rabi al-Awwal plus the Fatimiyya days), season { id, kind } (most specific of 14 liturgical seasons), eid, fastingRecommended, fastingForbidden, ashuraImsak, nightOfWorshipEve.
- nightOfWorshipEve is evening-anchored (the site's night convention): true on the civil day whose EVENING begins a night of worship — Ramadan 18/20/22 for the Nights of Qadr, 14 Sha'ban for its night.
- One if-statement themes a masjid site: mourning → drape, eid → festive.
کوڈ کے نمونے
curl
curl "https://theshia.org/api/v1/day-status"JavaScript
const res = await fetch("https://theshia.org/api/v1/day-status");
const data = await res.json();Python
import requests
data = requests.get("https://theshia.org/api/v1/day-status").json()حدود اور منصفانہ استعمال
جوابات ایج پر سختی سے کیش ہوتے ہیں — براہِ کرم اپنی طرف بھی کیش کریں۔ غیر کیش درخواستیں فی IP 100 فی منٹ تک محدود ہیں؛ 496 دن×طریقہ سے بڑی درخواستیں مسترد ہوتی ہیں۔ کمیونٹی کے لیے مفت، دستیابی کی ضمانت نہیں۔