বিনামূল্যের নামাজের সময়ের 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— ঐচ্ছিক। ডিগ্রিতে নিজস্ব ফজর ও ইশার কোণ, ১০ থেকে ২৫। ডিফল্ট: পদ্ধতির নিজস্ব কোণ।
রেসপন্স, সংক্ষেপে:
{
"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— আবশ্যক। জায়গার নাম, সর্বোচ্চ ২০০ অক্ষর।
[
{
"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 ফাইল ফেরত দেয়, ডিফল্টে এক মাস, সর্বোচ্চ ১২ মাস। এর 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— ফিড যত মাস জুড়ে থাকবে, ১ থেকে ১২। ডিফল্ট: ১।alarm— প্রতিটি নামাজের কত মিনিট আগে রিমাইন্ডার, ০ থেকে ১২০। ০ মানে কোনো অ্যালার্ম নেই। ডিফল্ট: ১০।sunrise,travel,ramadan,jumuah,busy— যথাক্রমে সূর্যোদয়, ভ্রমণের নোট, রমজানের ইভেন্ট, শুক্রবারে জুমুআ বা ব্যস্ত সময় চালু করতে ১ দিন। ডিফল্ট: বন্ধ।
কোড ছাড়াই একই ফিড বানাতে পারেন ক্যালেন্ডার সিঙ্ক পৃষ্ঠায়। ক্যালেন্ডার ফিডে প্রতি মিনিটে ৩০টি অনুরোধ চলে।
কাছের মসজিদ
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— ঐচ্ছিক। মিটারে খোঁজার ব্যাসার্ধ, ১০০ থেকে ৫০০০০। ডিফল্ট: ২০০০।
[
{
"id": 1234567,
"name": "Example Mosque",
"lat": 21.4231,
"lng": 39.8269,
"address": "Example Street 12",
"distance": 96.4
}
]কভারেজ OpenStreetMap-এর ওপর নির্ভর করে। একই ডেটার অ্যাপের ভেতরের দৃশ্য মসজিদ পৃষ্ঠায় বর্ণনা করা আছে।
রেট লিমিট
লিমিট এক মিনিটের জানালায় প্রতি IP ঠিকানার অনুরোধ গোনে। সীমা ছাড়ালে HTTP 429 পাবেন।
- নামাজের সময়: নিজস্ব কোনো সীমা নেই।
- ক্যালেন্ডার ফিড: প্রতি মিনিটে ৩০টি অনুরোধ।
- শহর খোঁজা ও কাছের মসজিদ একটি কোটা ভাগ করে: প্রতি মিনিটে ৩০টি অনুরোধ।
ব্রাউজার থেকে ব্যবহার
API কোনো CORS হেডার পাঠায় না, তাই অন্য সাইটের পৃষ্ঠা রেসপন্স পড়তে পারে না। এর বদলে এটি আপনার সার্ভার থেকে কল করুন। ওয়েবসাইটে শুধু সময়গুলো দেখাতে চাইলে ওয়েবসাইট উইজেট ব্যবহার করুন: একটি iframe, কোড নেই, কী নেই।
আরও দেখুন
- ওয়েবসাইট উইজেট — iframe হিসেবে নামাজের সময় বা হিজরি ক্যালেন্ডার।
- গণনা পদ্ধতি — ডিফল্ট পদ্ধতি কোনটি, আর অন্য বিকল্পগুলো।
- ক্যালেন্ডার সিঙ্ক — একই ফিড, একটি ফর্ম থেকে তৈরি।
পরবর্তী ধাপ
প্রশ্ন
নামাজের সময়ের API কি বিনামূল্যের, আর API কী লাগে কি?
হ্যাঁ, এটি বিনামূল্যের এবং কোনো কী, অ্যাকাউন্ট বা সাইনআপ লাগে না। প্যারামিটারসহ এন্ডপয়েন্টে একটি GET অনুরোধ পাঠান, আর রেট লিমিটের মধ্যে থাকুন।
শহরের নাম দিয়ে নামাজের সময় কীভাবে পাব?
q দিয়ে শহর খোঁজার এন্ডপয়েন্ট কল করুন, প্রথম ফলাফলের lat ও lon নিন, তারপর সেগুলো lat ও lng হিসেবে নামাজের সময়ের এন্ডপয়েন্টে দিন।
API ডিফল্টভাবে কোন গণনা পদ্ধতি ও আসরের নিয়ম ব্যবহার করে?
method না দিলে এটি আপনার স্থানাঙ্কের সবচেয়ে কাছের শহরের পদ্ধতি ব্যবহার করে। asr না দিলে ওই শহরের দেশের প্রচলিত আসরের রীতি ব্যবহার করে। দুটোই নির্দিষ্ট করতে চাইলে দুটোই পাঠান।
রেসপন্সে একটি নামাজ নেই কেন?
মেরুর কাছাকাছি অঞ্চলে সূর্য কখনো ফজর বা ইশার কোণে পৌঁছায় না, তাই দেওয়ার মতো কোনো সময় থাকে না। অবৈধ তারিখ ফেরত না দিয়ে API ওই নামাজটি বাদ দেয়।
আমি কি ব্রাউজারে JavaScript থেকে API কল করতে পারি?
API কোনো CORS হেডার পাঠায় না, তাই অন্য সাইটের পৃষ্ঠা রেসপন্স পড়তে পারে না। এটি আপনার সার্ভার থেকে কল করুন, অথবা কোড ছাড়াই চলে এমন এমবেড করার উইজেট ব্যবহার করুন।
রেট লিমিট কত?
লিমিট এক মিনিটের জানালায় প্রতি IP ঠিকানার অনুরোধ গোনে। ক্যালেন্ডার ফিডে মিনিটে ৩০টি অনুরোধ চলে, আর শহর খোঁজা ও কাছের মসজিদ মিনিটে ৩০টির একটি ভাগ করা কোটা ব্যবহার করে। সীমা ছাড়ালে HTTP 429 পাবেন।
কত ঘনঘন নামাজের সময় চাইব?
প্রতিটি স্থানের জন্য দিনে একবারই যথেষ্ট। রেসপন্স সংরক্ষণ করে রাখুন এবং কাউন্টডাউন নিজে হিসাব করুন; ইশার পরের ঘণ্টাগুলোর জন্য আগামীকালের ফজরও দেওয়া থাকে।
iCal ফিড আছে কি?
হ্যাঁ। ক্যালেন্ডার ফিড নামাজের সময় ও ইসলামি অনুষ্ঠানের একটি সাবস্ক্রাইব করার মতো .ics ফাইল দেয়, ডিফল্টে এক মাস, আর months প্যারামিটার দিয়ে ১২ মাস পর্যন্ত।