API
رابطهای JSON رایگان و باز با همان موتورهای این سایت و اپلیکیشنهای TheShia Group. بدون کلید و حساب — فقط استفادهٔ منصفانه.
نشانی پایه
https://theshia.org/api/v1
اوقات شرعی
GET /v1/prayer-times محاسبات جعفری (شیعی) برای هر نقطهٔ زمین — روشهای آماده، چند روش همزمان، یا زوایای کاملاً سفارشی؛ یک روز، یک ماه یا یک سال کامل در هر درخواست. عرضهای جغرافیایی بالا با قاعدهٔ TwilightAngle مدیریت میشود و نیمهشب شرعی میانهٔ غروب تا اذان صبح است. روشهای محاسبه
GET /v1/methods شانزده روش پشتیبانیشده، از جمله دانشگاه تهران، جعفری (مؤسسهٔ لوا — قم)، شیخ کلباسی و مرکز اسلامی انگلستان. قبله
GET /v1/qibla زاویهٔ قبله بر حسب درجه از شمال حقیقی برای هر مختصاتی. جستوجوی شهر
GET /v1/cities در ۳۲۵ شهر گلچینشده به انگلیسی، عربی، فارسی یا اردو جستوجو کنید — مختصات و منطقهٔ زمانی را برای خدمت اوقات برمیگرداند. تبدیل تاریخ قمری
GET /v1/hijri تبدیل تاریخ در هر دو جهت میان تقویم هجری قمری و میلادی — یک روز، یک ماه کامل یا یک سال در هر درخواست، بر اساس رؤیت جهانی هلال یا تقویم رسمی ایران. ماههای اعلامشده از جدولهای معتبر پاسخ داده میشوند و فراتر از آن، رؤیتپذیری واقعی هلال بهصورت نجومی محاسبه میشود و هر پاسخ منبع خود را اعلام میکند. مناسبتهای اسلامی
GET /v1/events تقویم گلچینشدهٔ اهلبیت علیهمالسلام — ۷۳ مناسبت با تاریخهای شیعی و عنوان به چهار زبان؛ قابل تبدیل به هر سال یا پرسش مناسبتهای پیشِ رو. گرفتگیها
GET /v1/eclipses خورشیدگرفتگیها و ماهگرفتگیهای ۲۰۲۰ تا ۲۰۴۰ — نوع، زمان اوج، بزرگی، مدتها و نقطهٔ اوج زمینی، از همان موتور سنجیدهای که نقشههای گرفتگی را میسازد. وضعیت روز
GET /v1/day-status امروز (یا هر تاریخ) به صورت پرچمهای ماشینخوان — تاریخ قمری، مناسبتهای روز و نشانگرهای ایام سوگ و جشن و روزه و شبهای عبادت — تا سایتها و اپها خودکار حالوهوا بگیرند. فیدهای تقویم (ICS)
GET /v1/calendar-feeds یک بار در تقویم Google یا Apple مشترک شوید: همهٔ مناسبتهای اسلامی یا اوقات شرعی یک شهر — همیشه بهروز، بدون نیاز به اپ. رؤیتپذیری ماه
GET /v1/moon-visibility دادهٔ رؤیت هلال پشت نقشههای رؤیت — شبکهٔ مناطق جهانی برای هر شب از پنجرهٔ رؤیت ماه قمری، یا رؤیتپذیری برای یک مکان مشخص با تاریخ نخستین رؤیت بر اساس هر معیار (یالوپ/شوکت، تنظیمشده با moonsighting.com).
محدودیتها و استفادهٔ منصفانه
پاسخها بهشدت در لبه کش میشوند — لطفاً شما هم کش کنید. درخواستهای بدون کش به ۱۰۰ در دقیقه بهازای هر IP محدودند؛ درخواستهای بیش از ۴۹۶ محاسبهٔ روز×روش رد میشوند. برای استفادهٔ اجتماعی رایگان است، بدون تضمین دسترسپذیری.