API

مفت اور کھلے JSON API — اسی انجن پر جو یہ سائٹ اور TheShia Group کی ایپس چلاتی ہیں۔ نہ کلید، نہ اکاؤنٹ — بس منصفانہ استعمال۔

بنیادی URL

https://theshia.org/api/v1

مشین ریڈایبل دستاویزات مع زندہ مثالیں ↗ OpenAPI اسپیسیفیکیشن (JSON) ↗

اوقاتِ نماز GET /v1/prayer-times زمین پر کسی بھی مقام کے لیے جعفری (شیعہ) حسابات — تیار طریقے، بیک وقت کئی، یا مکمل اپنی مرضی کے زاویے؛ فی درخواست ایک دن، مہینہ یا پورا سال۔ بلند عرض البلد TwilightAngle قاعدے سے سنبھالے جاتے ہیں اور شرعی نصف شب غروب تا صبحِ صادق کا وسط ہے۔ طریقہ ہائے حساب GET /v1/methods سولہ معاون طریقے، بشمول جامعہ تہران، جعفری (لیوا انسٹیٹیوٹ، قم)، شیخ کلباسی اور اسلامک سینٹر آف انگلینڈ۔ سمتِ قبلہ GET /v1/qibla کسی بھی مقام کے لیے حقیقی شمال سے درجوں میں قبلہ کا رخ۔ تلاشِ شہر GET /v1/cities 325 منتخب شہروں میں انگریزی، عربی، فارسی یا اردو نام سے تلاش — اوقات کی سروس کے لیے مقام اور ٹائم زون دیتی ہے۔ ہجری تاریخ کی تبدیلی GET /v1/hijri ہجری اور عیسوی کیلنڈر کے درمیان دونوں سمتوں میں تاریخ کی تبدیلی — ہر درخواست میں ایک دن، پورا مہینہ یا پورا سال، عالمی رؤیتِ ہلال یا ایران کے سرکاری کیلنڈر کے مطابق۔ اعلان شدہ مہینوں کا جواب مستند جدولوں سے دیا جاتا ہے، اس سے آگے چاند کی حقیقی رؤیت کا فلکیاتی حساب لگایا جاتا ہے، اور ہر جواب اپنا ماخذ بتاتا ہے۔ اسلامی مناسبتیں GET /v1/events اہلِ بیت علیہم السلام کا منتخب کیلنڈر — 73 مناسبتیں، شیعہ تاریخوں اور چار زبانوں کے عنوانات کے ساتھ؛ کسی بھی سال میں تبدیل یا آنے والی مناسبتیں دریافت کریں۔ گرہن GET /v1/eclipses 2020 تا 2040 کے سورج اور چاند گرہن — اقسام، عروج کے اوقات، مقدار، دورانیے اور عظیم ترین گرہن کے مقامات، اسی تصدیق شدہ انجن سے جو گرہن کے نقشے بناتا ہے۔ یومی کیفیت GET /v1/day-status آج (یا کوئی تاریخ) مشین کے پڑھنے لائق فلیگز میں — ہجری تاریخ، دن کے مواقع اور سوگ/جشن، روزہ اور شبِ عبادت کے اشارے — تاکہ مسجد سائٹس اور ایپس خود بخود اپنا رنگ بدلیں۔ کیلنڈر فیڈز (ICS) GET /v1/calendar-feeds Google یا Apple کیلنڈر میں ایک بار سبسکرائب کریں: تمام اسلامی تاریخیں یا کسی شہر کے اوقات — ہمیشہ تازہ، بغیر کسی ایپ کے۔ چاند کی رویت GET /v1/moon-visibility رویت ہلال نقشوں کے پیچھے کا ڈیٹا — ہجری مہینے کی رویت ونڈو کی کسی بھی شام کے لیے عالمی زون گرڈ، یا کسی مقام کے لیے ہر معیار کے مطابق پہلی رویت کی تاریخوں سمیت رویت (یالوپ/شوکت، moonsighting.com سے ہم آہنگ)۔

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

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