বিনামূল্যে নামাজের সময়ের API: কোনো কী লাগে না

একটি স্থানের নামাজের সময়

GET /prayer/api/times

একজোড়া স্থানাঙ্কের জন্য আজকের ফজর, সূর্যোদয়, জোহর, আসর, মাগরিব ও এশা, সঙ্গে আগামীকালের ফজর। প্রতিটি সময় UTC-তে ISO 8601 মুহূর্ত। ওই অক্ষাংশে ওই দিনে যে সময় নেই তা বাদ দেওয়া হয়।

প্যারামিটার

lat আবশ্যক

দশমিক ডিগ্রিতে অক্ষাংশ।

lng আবশ্যক

দশমিক ডিগ্রিতে দ্রাঘিমাংশ।

method ঐচ্ছিক

হিসাব পদ্ধতির আইডি, যেমন muslim-world-league, north-america বা karachi। ডিফল্ট: নিকটতম শহরের পদ্ধতি।

madhab ঐচ্ছিক

Hanafi বা Shafi, যা আসরের সময় ঠিক করে। ডিফল্ট: নিকটতম শহরের দেশের প্রচলিত নিয়ম।

hlr ঐচ্ছিক

উচ্চ অক্ষাংশের নিয়ম: auto, middle-of-the-night, seventh-of-the-night বা twilight-angle। ডিফল্ট: auto।

fa ঐচ্ছিক

ফজরের নিজস্ব কোণ ডিগ্রিতে, ১০ থেকে ২৫। ডিফল্ট: পদ্ধতির নিজস্ব কোণ।

ia ঐচ্ছিক

এশার নিজস্ব কোণ ডিগ্রিতে, ১০ থেকে ২৫। ডিফল্ট: পদ্ধতির নিজস্ব কোণ।

উদাহরণ

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

const res = await fetch('https://qurangallery.com/prayer/api/times?lat=21.4225&lng=39.8262');
const { date, times, fajrTomorrow } = await res.json();

রেসপন্স

{
  "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"
}

ক্যালেন্ডার ফিড (iCal)

GET /prayer/api/calendar/feed.ics

সাবস্ক্রাইব করার মতো .ics ফিড, যাতে ডিফল্টভাবে আগামী এক মাসের এবং months প্যারামিটারে ১২ মাস পর্যন্ত নামাজের সময় ও ইসলামি দিবস আছে। URL-টি Google Calendar, Apple Calendar বা Outlook-এ ক্যালেন্ডার সাবস্ক্রিপশন হিসেবে যোগ করুন।

প্যারামিটার

lat আবশ্যক

দশমিক ডিগ্রিতে অক্ষাংশ।

lng আবশ্যক

দশমিক ডিগ্রিতে দ্রাঘিমাংশ।

method ঐচ্ছিক

হিসাব পদ্ধতির আইডি, যেমন muslim-world-league, north-america বা karachi। ডিফল্ট: নিকটতম শহরের পদ্ধতি।

madhab ঐচ্ছিক

Hanafi বা Shafi, যা আসরের সময় ঠিক করে। ডিফল্ট: নিকটতম শহরের দেশের প্রচলিত নিয়ম।

authority ঐচ্ছিক

অনুষ্ঠানের জন্য হিজরি ক্যালেন্ডার কর্তৃপক্ষ, যেমন umm_al_qura বা diyanet। ডিফল্ট: নিকটতম শহরের দেশের কর্তৃপক্ষ।

months ঐচ্ছিক

ফিড কত মাস কভার করবে, ১ থেকে ১২। ডিফল্ট: ১।

alarm ঐচ্ছিক

প্রতিটি নামাজের কত মিনিট আগে অনুস্মারক বাজবে, ০ থেকে ১২০। ০ মানে কোনো অ্যালার্ম নেই। ডিফল্ট: ১০।

a_<prayer> ঐচ্ছিক

একটি নামাজের জন্য অ্যালার্মের মিনিট, ০ থেকে ১২০, alarm-এর বদলে কাজ করে। <prayer>-এর জায়গায় fajr, dhuhr, asr, maghrib বা isha লিখুন, যেমন a_fajr=15।

o_<prayer> ঐচ্ছিক

একটি নামাজকে এত মিনিট এগিয়ে বা পিছিয়ে দিন, -৬০ থেকে ৬০। <prayer>-এর জায়গায় fajr, dhuhr, asr, maghrib বা isha লিখুন, যেমন o_isha=5। ডিফল্ট: ০।

sunrise ঐচ্ছিক

ফিডে সূর্যোদয় যোগ করতে ১ দিন। ডিফল্ট: বন্ধ।

travel ঐচ্ছিক

ভ্রমণে জোহর, আসর ও এশা ২ রাকাত কসর হয়, এই নোট যোগ করতে ১ দিন। ডিফল্ট: বন্ধ।

ramadan ঐচ্ছিক

রমজানের দিনগুলোতে সাহরি শেষ (ফজরে), ইফতার (মাগরিবে) ও তারাবিহ (ইশার ১৫ মিনিট পর, এক ঘণ্টা) যোগ করতে 1 দিন। দিনগুলো authority প্যারামিটার অনুসরণ করে। ডিফল্ট: বন্ধ।

jumuah ঐচ্ছিক

শুক্রবার যোহরের ইভেন্টের নাম “জুমুআ” করতে 1 দিন। ডিফল্ট: বন্ধ।

jumuahLead ঐচ্ছিক

জুমুআর রিমাইন্ডার কত মিনিট আগে, ০ থেকে ১২০; ০ মানে রিমাইন্ডার নেই। শুক্রবার যোহরের রিমাইন্ডারের জায়গা নেয় এবং jumuah=1 লাগে। ডিফল্ট: যোহরের রিমাইন্ডার।

busy ঐচ্ছিক

নামাজের ইভেন্টগুলো ব্যস্ত হিসেবে চিহ্নিত করতে 1 দিন (TRANSP:OPAQUE)। ডিফল্ট: ফাঁকা (TRANSP:TRANSPARENT)।

hlr ঐচ্ছিক

উচ্চ অক্ষাংশের নিয়ম: auto, middle-of-the-night, seventh-of-the-night বা twilight-angle। ডিফল্ট: auto।

fa ঐচ্ছিক

ফজরের নিজস্ব কোণ ডিগ্রিতে, ১০ থেকে ২৫। ডিফল্ট: পদ্ধতির নিজস্ব কোণ।

ia ঐচ্ছিক

এশার নিজস্ব কোণ ডিগ্রিতে, ১০ থেকে ২৫। ডিফল্ট: পদ্ধতির নিজস্ব কোণ।

উদাহরণ

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

রেসপন্স

ডিফল্টভাবে এক মাসের, months দিয়ে ১২ মাস পর্যন্ত ইভেন্টসহ একটি text/calendar (iCalendar) নথি।

শহর খোঁজা

GET /prayer/api/location/search

স্থানের নামকে স্থানাঙ্ক, দেশের কোড ও টাইম জোনে বদলে দেয়। প্রথমে আমাদের নিজস্ব শহরের তালিকায় খোঁজে। কোনো মিল না পেলে খালি অ্যারে ফেরত আসে।

প্যারামিটার

q আবশ্যক

স্থানের নাম, সর্বোচ্চ ২০০ অক্ষর।

উদাহরণ

curl 'https://qurangallery.com/prayer/api/location/search?q=Makkah'

const res = await fetch('https://qurangallery.com/prayer/api/location/search?q=Makkah');
const places = await res.json();

রেসপন্স

[
  {
    "lat": 21.4266,
    "lon": 39.8256,
    "displayName": "Makkah, Saudi Arabia",
    "countryCode": "SA",
    "timezone": "Asia/Riyadh"
  }
]

কাছের মসজিদ

GET /prayer/api/mosques/nearby

একটি বিন্দুর আশপাশের মসজিদ, কাছেরটি আগে, OpenStreetMap তথ্য থেকে। দূরত্ব মিটারে। মানচিত্রের তথ্য সেবা না পাওয়া গেলে উত্তর 503।

প্যারামিটার

lat আবশ্যক

দশমিক ডিগ্রিতে অক্ষাংশ।

lng আবশ্যক

দশমিক ডিগ্রিতে দ্রাঘিমাংশ।

radius ঐচ্ছিক

মিটারে খোঁজার ব্যাসার্ধ, ১০০ থেকে ৫০০০০। ডিফল্ট: ২০০০।

উদাহরণ

curl 'https://qurangallery.com/prayer/api/mosques/nearby?lat=21.4225&lng=39.8262&radius=2000'

const res = await fetch('https://qurangallery.com/prayer/api/mosques/nearby?lat=21.4225&lng=39.8262&radius=2000');
const mosques = await res.json();

রেসপন্স

[
  {
    "id": 1234567,
    "name": "Example Mosque",
    "lat": 21.4231,
    "lng": 39.8269,
    "address": "Example Street 12",
    "distance": 96.4
  }
]

রেট লিমিট

লিমিট এক মিনিটের জানালায় প্রতি IP ঠিকানার অনুরোধ গোনে। সীমা পেরোলে HTTP 429 পাবেন।

• নামাজের সময়: এর নিজস্ব কোনো সীমা নেই। প্রতিটি পেজ দেখার সময় কল না করে প্রতিটি স্থানের উত্তর দিনভর ক্যাশ করে রাখুন।
• ক্যালেন্ডার ফিড: প্রতি মিনিটে ৩০টি অনুরোধ।
• শহর খোঁজা ও কাছের মসজিদ একই সীমা ভাগ করে: প্রতি মিনিটে ৩০টি অনুরোধ।