کیلنڈر فیڈز (ICS)

Google یا Apple کیلنڈر میں ایک بار سبسکرائب کریں: تمام اسلامی تاریخیں یا کسی شہر کے اوقات — ہمیشہ تازہ، بغیر کسی ایپ کے۔

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

پیرامیٹرز

lang default: en feed language — values: "en" · "ar" · "fa" · "ur".
importance optional value: "major" — a lighter feed with only the headline events.
calendar default: moonsighting values: "moonsighting" · "iran".
city prayer/night feeds REQUIRED for /prayer-times.ics and /night.ics — a city id from /cities.
method prayer/night feeds calculation method id (default Tehran).
days prayer/night feeds rolling window, 7 to 90 (default 60).
offsets prayer feed masjid-kit jamaat offsets, e.g. "fajr:10,maghrib:5" — minutes after the calculated time, -60 to 180.
name prayer feed masjid display name for the calendar title and event summaries (max 60 characters).

Four feeds: GET /api/v1/events.ics (Islamic events as all-day entries, ~14 months around today), GET /api/v1/prayer-times.ics?city=<id> (the five daily prayers, timed — with optional jamaat offsets and masjid name), GET /api/v1/fasting.ics (recommended fasting days — Ayyam al-Bid and the emphasized fasts), and GET /api/v1/night.ics?city=<id> (Salat al-Layl: one event at the last third of every night).
Subscribe via webcal:// (Apple, most clients) or paste the https URL into Google Calendar → “From URL”. Feeds refresh daily (X-PUBLISHED-TTL P1D) and stay current with announced sightings.

زندہ مثال کھولیں ↗

کوڈ کے نمونے

curl

curl "https://theshia.org/api/v1/events.ics?lang=en&importance=major"

JavaScript

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

Python

import requests

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

حدود اور منصفانہ استعمال

جوابات ایج پر سختی سے کیش ہوتے ہیں — براہِ کرم اپنی طرف بھی کیش کریں۔ غیر کیش درخواستیں فی IP 100 فی منٹ تک محدود ہیں؛ 496 دن×طریقہ سے بڑی درخواستیں مسترد ہوتی ہیں۔ کمیونٹی کے لیے مفت، دستیابی کی ضمانت نہیں۔