مواد پر جائیں

نماز کے اوقات کا مفت API، API کلید کے بغیر

نماز کے اوقات کا مفت API، کلید یا سائن اپ کے بغیر۔ عرض بلد اور طول بلد سے روزانہ اوقات JSON میں لیں، ساتھ iCal فیڈ، شہر کی تلاش اور قریبی مساجد۔

اس صفحے پر

qurangallery.com/prayer/developers پر نماز کے اوقات کا API مفت ہے اور اسے API کلید یا سائن اپ کی ضرورت نہیں۔ چار عوامی اینڈ پوائنٹ ہیں: عرض بلد اور طول بلد کے لیے JSON میں روزانہ نماز کے اوقات، قابلِ سبسکرپشن iCal فیڈ، شہر کی تلاش اور قریبی مساجد۔

ہر اینڈ پوائنٹ https://qurangallery.com/prayer کے تحت ہے۔ غلط ان پٹ پر 400 اور بہت زیادہ درخواستوں پر 429 ملتا ہے۔

کسی مقام کے لیے نماز کے اوقات

GET /api/times نقاط کے جوڑے کے لیے آج کی فجر، طلوع آفتاب، ظہر، عصر، مغرب اور عشاء لوٹاتا ہے، ساتھ کل کی فجر۔ ہر وقت UTC میں ISO 8601 لمحہ ہے۔ جو وقت اس عرض بلد پر اس دن موجود نہ ہو اسے چھوڑ دیا جاتا ہے۔

curl 'https://qurangallery.com/prayer/api/times?lat=21.4225&lng=39.8262'

پیرامیٹرز:

  • lat — لازمی۔ اعشاری ڈگری میں عرض بلد۔
  • lng — لازمی۔ اعشاری ڈگری میں طول بلد۔
  • method — اختیاری۔ حساب کے طریقے کی شناخت، مثلاً mwl، isna یا karachi۔ طے شدہ: قریب ترین شہر کا طریقہ۔
  • asr — اختیاری۔ standard یا hanafi، جو عصر کا وقت طے کرتا ہے۔ طے شدہ: قریب ترین شہر کے ملک کا معمول۔
  • hlr — اختیاری۔ بلند عرض بلد کا اصول: auto، middle-of-the-night، seventh-of-the-night یا twilight-angle۔ طے شدہ: auto۔
  • fa اور ia — اختیاری۔ فجر اور عشاء کا اپنا زاویہ ڈگری میں، 10 سے 25 تک۔ طے شدہ: طریقے کا اپنا زاویہ۔

جواب، مختصر:

{
  "date": "2026-10-31",
  "times": [
    { "name": "fajr", "time": "2026-10-31T02:06:00.000Z", "isCurrent": false, "isNext": true },
    { "name": "sunrise", "time": "2026-10-31T03:23:00.000Z", "isCurrent": false, "isNext": false },
    { "name": "dhuhr", "time": "2026-10-31T09:04:00.000Z", "isCurrent": false, "isNext": false },
    { "name": "asr", "time": "2026-10-31T12:20:00.000Z", "isCurrent": false, "isNext": false },
    { "name": "maghrib", "time": "2026-10-31T14:45:00.000Z", "isCurrent": false, "isNext": false },
    { "name": "isha", "time": "2026-10-31T16:15:00.000Z", "isCurrent": false, "isNext": false }
  ],
  "fajrTomorrow": "2026-11-01T02:06:00.000Z"
}

تاریخ نقاط کا اپنا مقامی دن ہے۔ نماز کے اوقات پر الگ سے کوئی حد نہیں، اس لیے ہر صفحے کے ملاحظے پر کال کرنے کے بجائے ہر مقام کا جواب دن بھر کے لیے کیش کریں۔

شہر کی تلاش

GET /api/location/search کسی جگہ کے نام کو نقاط، ملک کے کوڈ اور ٹائم زون میں بدلتا ہے۔ یہ پہلے ایپ کی اپنی شہروں کی فہرست میں تلاش کرتا ہے، اور جس سوال کا کوئی میل نہ ہو وہ خالی ایرے لوٹاتا ہے۔

curl 'https://qurangallery.com/prayer/api/location/search?q=Makkah'
  • q — لازمی۔ جگہ کا نام، زیادہ سے زیادہ 200 حروف۔
[
  {
    "lat": 21.4266,
    "lon": 39.8256,
    "displayName": "Makkah, Saudi Arabia",
    "countryCode": "SA",
    "timezone": "Asia/Riyadh"
  }
]

پہلے نتیجے کے lat اور lon لیں اور انہیں lat اور lng کے طور پر نماز کے اوقات کے اینڈ پوائنٹ کو دیں۔

کیلنڈر فیڈ (iCal)

GET /api/calendar/feed.ics ایک قابلِ سبسکرپشن text/calendar فائل لوٹاتا ہے جس میں نماز کے اوقات اور اسلامی مواقع ہیں، بطورِ طے شدہ ایک مہینہ اور زیادہ سے زیادہ 12 مہینے۔ اس کا URL Google کیلنڈر، Apple کیلنڈر یا Outlook میں کیلنڈر سبسکرپشن کے طور پر شامل کریں۔

curl 'https://qurangallery.com/prayer/api/calendar/feed.ics?lat=21.4225&lng=39.8262'

لازمی: lat اور lng۔ اختیاری: method، asr، hlr، fa، ia جیسا اوپر، نیز:

  • authority — مواقع کے لیے ہجری کیلنڈر کی اتھارٹی، مثلاً umm_al_qura یا diyanet۔ طے شدہ: قریب ترین شہر کے ملک کی اتھارٹی۔
  • months — فیڈ جتنے مہینے کا احاطہ کرے، 1 سے 12 تک۔ طے شدہ: 1۔
  • alarm — ہر نماز سے پہلے یاد دہانی کے منٹ، 0 سے 120 تک۔ 0 کا مطلب کوئی الارم نہیں۔ طے شدہ: 10۔
  • sunrise، travel، ramadan، jumuah، busy — طلوع آفتاب، سفر کا نوٹ، رمضان کے مواقع، جمعہ کے دن جمعہ، یا مصروف وقت آن کرنے کے لیے 1 رکھیں۔ طے شدہ: بند۔

آپ یہی فیڈ بغیر کوڈ کے کیلنڈر سنک صفحے پر بھی بنا سکتے ہیں۔ کیلنڈر فیڈ فی منٹ 30 درخواستوں کی اجازت دیتی ہے۔

قریبی مساجد

GET /api/mosques/nearby کسی نقطے کے گرد مساجد کی فہرست دیتا ہے، قریب ترین پہلے، OpenStreetMap کے ڈیٹا سے۔ فاصلہ میٹروں میں ہے۔ جب نقشے کے ڈیٹا کی سروسز دستیاب نہ ہوں تو جواب 503 ہوتا ہے۔

curl 'https://qurangallery.com/prayer/api/mosques/nearby?lat=21.4225&lng=39.8262&radius=2000'
  • lat اور lng — لازمی۔
  • radius — اختیاری۔ تلاش کا رداس میٹروں میں، 100 سے 50000 تک۔ طے شدہ: 2000۔
[
  {
    "id": 1234567,
    "name": "Example Mosque",
    "lat": 21.4231,
    "lng": 39.8269,
    "address": "Example Street 12",
    "distance": 96.4
  }
]

احاطہ OpenStreetMap پر منحصر ہے۔ اسی ڈیٹا کا ایپ کے اندر کا منظر مساجد کے صفحے میں بیان ہے۔

ریٹ کی حدیں

حدیں فی IP ایڈریس ایک منٹ کی کھڑکی میں درخواستیں گنتی ہیں۔ حد کے بعد HTTP 429 ملتا ہے۔

  • نماز کے اوقات: اپنی کوئی حد نہیں۔
  • کیلنڈر فیڈ: فی منٹ 30 درخواستیں۔
  • شہر کی تلاش اور قریبی مساجد ایک مشترکہ کوٹا بانٹتی ہیں: فی منٹ 30 درخواستیں۔

براؤزر سے استعمال

API کوئی CORS ہیڈر نہیں بھیجتا، اس لیے دوسری سائٹ کا صفحہ جواب نہیں پڑھ سکتا۔ اس کے بجائے اسے اپنے سرور سے کال کریں۔ اگر آپ صرف کسی ویب سائٹ پر اوقات دکھانا چاہتے ہیں تو ویب سائٹ ویجٹ استعمال کریں: ایک iframe، کوئی کوڈ نہیں اور کوئی کلید نہیں۔

یہ بھی دیکھیں

اگلے مراحل

سوالات

کیا نماز کے اوقات کا API مفت ہے، اور کیا مجھے API کلید چاہیے؟

جی ہاں، یہ مفت ہے اور اسے کلید، اکاؤنٹ یا سائن اپ کی ضرورت نہیں۔ پیرامیٹرز کے ساتھ اینڈ پوائنٹ پر GET درخواست بھیجیں، اور ریٹ کی حدوں کے اندر رہیں۔

شہر کے نام سے نماز کے اوقات کیسے لوں؟

q کے ساتھ شہر کی تلاش کا اینڈ پوائنٹ کال کریں، پہلے نتیجے کے lat اور lon لیں، پھر انہیں lat اور lng کے طور پر نماز کے اوقات کے اینڈ پوائنٹ کو دیں۔

API بطورِ طے شدہ کون سا حساب کا طریقہ اور عصر کا اصول استعمال کرتا ہے؟

method نہ دیا جائے تو یہ آپ کے نقاط کے قریب ترین شہر کا طریقہ استعمال کرتا ہے۔ asr نہ دیا جائے تو اس شہر کے ملک کا معمول کا عصر کا اصول۔ دونوں بھیج کر انہیں مقرر کر لیں۔

جواب میں کوئی نماز کیوں غائب ہے؟

قطبین کے قریب سورج فجر یا عشاء کی زاویے تک کبھی نہیں پہنچتا، اس لیے دینے کو کوئی وقت نہیں ہوتا۔ API غلط تاریخ لوٹانے کے بجائے اس نماز کو چھوڑ دیتا ہے۔

کیا میں براؤزر میں JavaScript سے API کال کر سکتا ہوں؟

API کوئی CORS ہیڈر نہیں بھیجتا، اس لیے دوسری سائٹ کا صفحہ جواب نہیں پڑھ سکتا۔ اسے اپنے سرور سے کال کریں، یا ایمبیڈ ہونے والا ویجٹ استعمال کریں جسے کوڈ کی ضرورت نہیں۔

ریٹ کی حدیں کیا ہیں؟

حدیں فی IP ایڈریس ایک منٹ کی کھڑکی میں درخواستیں گنتی ہیں۔ کیلنڈر فیڈ فی منٹ 30 درخواستوں کی اجازت دیتی ہے، اور شہر کی تلاش اور قریبی مساجد فی منٹ 30 کا ایک مشترکہ کوٹا بانٹتی ہیں۔ حد کے بعد HTTP 429 ملتا ہے۔

مجھے نماز کے اوقات کتنی بار مانگنے چاہییں؟

ہر مقام کے لیے دن میں ایک بار کافی ہے۔ جواب محفوظ کر لیں اور الٹی گنتی خود نکالیں؛ عشاء کے بعد کے گھنٹوں کے لیے کل کی فجر شامل ہے۔

کیا iCal فیڈ ہے؟

جی ہاں۔ کیلنڈر فیڈ ایک قابلِ سبسکرپشن .ics فائل لوٹاتی ہے جس میں نماز کے اوقات اور اسلامی مواقع ہیں، بطورِ طے شدہ ایک مہینہ اور months پیرامیٹر سے 12 مہینوں تک۔

اس صفحے کو GitHub پر ایڈٹ کریں