مناسبت‌های اسلامی

تقویم گلچین‌شدهٔ اهل‌بیت علیهم‌السلام — ۷۳ مناسبت با تاریخ‌های شیعی و عنوان به چهار زبان؛ قابل تبدیل به هر سال یا پرسش مناسبت‌های پیشِ رو.

GET https://theshia.org/api/v1/events

پارامترها

hm optional Hijri month 1 to 12 — list that month's events.
hy optional Hijri year 1317 to 1523 — resolve every event to its Gregorian date in that year (combinable with hm).
upcoming optional 1 to 73 — the next N occurrences from today, each with gregorian date and daysUntil.
importance optional value: "major" — only the headline events (Ashura, Arbaeen, Eids, the Masumin…).
type optional values: "occasion" · "birth" · "martyrdom" · "death" · "holy".
details optional value: "1" — include the detail paragraphs (en/ar/fa; 44 events have them).
calendar default: moonsighting values: "moonsighting" · "iran" — the reckoning used to resolve dates.

73 curated events (Shia dates), titles in en/ar/fa/ur with honorifics. Events recur on their Hijri month/day; a day-30 event resolves to null in years where its month has 29 days.
Response per event: id, hijriMonth, hijriDay, type, importance, title { en, ar, fa, ur } (+ hijriYear, gregorian, daysUntil/source in resolved modes).

بازکردن مثال زنده ↗

نمونه کد

curl

curl "https://theshia.org/api/v1/events?upcoming=5&importance=major"

JavaScript

const res = await fetch("https://theshia.org/api/v1/events?upcoming=5&importance=major");
const data = await res.json();

Python

import requests

data = requests.get("https://theshia.org/api/v1/events?upcoming=5&importance=major").json()

محدودیت‌ها و استفادهٔ منصفانه

پاسخ‌ها به‌شدت در لبه کش می‌شوند — لطفاً شما هم کش کنید. درخواست‌های بدون کش به ۱۰۰ در دقیقه به‌ازای هر IP محدودند؛ درخواست‌های بیش از ۴۹۶ محاسبهٔ روز×روش رد می‌شوند. برای استفادهٔ اجتماعی رایگان است، بدون تضمین دسترس‌پذیری.