حالة اليوم

اليوم (أو أي تاريخ) كأعلام قابلة للقراءة آليًا — التاريخ الهجري وأحداث اليوم ومؤشرات مواسم الحزن والفرح والصيام وليالي العبادة — لتتزين مواقع المساجد والتطبيقات تلقائيًا.

GET https://theshia.org/api/v1/day-status

المعاملات

date default: today the day to describe, YYYY-MM-DD (years 1900 to 2100).
calendar default: 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؛ والطلبات الضخمة (أكثر من ٤٩٦ حسابَ يوم×طريقة) تُرفض. مجاني للاستخدام المجتمعي، بلا ضمان توافر.