নামাজের সময়, API ও MCP-এর মাধ্যমে

কী পাওয়ার উপায়

1. 1পাসকি দিয়ে সাইন ইন করুন অথবা আপনার ইমেইল দিয়ে অ্যাকাউন্ট তৈরি করুন। কোনো পাসওয়ার্ড নেই, এবং আপনার Minare Qur'an অ্যাকাউন্ট এখানেও কাজ করে।
2. 2ডেভেলপার ড্যাশবোর্ডে একটি কী তৈরি করুন। এটি শুধু একবার দেখানো হয়; আমরা কেবল এর হ্যাশ সংরক্ষণ করি।
3. 3আপনার অনুরোধগুলোতে কী যোগ করুন। আপনি Trial প্ল্যান দিয়ে শুরু করবেন; আরও প্রয়োজন হলে ড্যাশবোর্ড থেকে আপগ্রেড করুন।

প্রমাণীকরণ

প্রতিটি অনুরোধে আপনার কী পাঠান: Authorization: Bearer mk_… অথবা X-API-Key: mk_…। বৈধ কী ছাড়া অনুরোধ 401 পায়, বাতিল করা কী 403 পায়; রেসপন্সের বডিতে এই পাতার লিংক থাকে।

উদাহরণ

curl https://minare.app/api/v1/times?city=istanbul \
  -H "Authorization: Bearer mk_…"

এন্ডপয়েন্টসমূহ

• GET /api/v1/times?city=Kadıköy

  এক দিন: ইমসাক, ফজর, সূর্যোদয়, যোহর, আসর, মাগরিব, এশা ও অতিরিক্ত সময়

• GET /api/v1/month?city=london&year=2027&month=2

  এক মাসের সময়সূচি

• GET /api/v1/next?lat=41.01&lon=28.98

  পরবর্তী নামাজ ও বাকি সেকেন্ড

• GET /api/v1/qibla?city=berlin

  কিবলার কোণ ও কাবা পর্যন্ত দূরত্ব

• GET /api/v1/cities?q=ist

  শহর ও জেলা খুঁজুন

• GET /api/v1/hijri?date=2027-02-08

  হিজরি তারিখ

সাধারণ প্যারামিটার

city

শহরের নাম (Kadıköy, London) অথবা minare.app পাথ (turkey/istanbul/kadikoy)

lat, lon, tz

শহরের বদলে স্থানাঙ্ক; সময় অঞ্চলের জন্য tz যোগ করুন

date

YYYY-MM-DD; না দিলে স্থানীয় আজকের তারিখ

method

হিসাব পদ্ধতি; না দিলে দেশ অনুযায়ী বেছে নেওয়া হয়

madhab

shafi অথবা hanafi; না দিলে দেশ অনুযায়ী বেছে নেওয়া হয়

সীমা

প্রতিটি রেসপন্সে প্রতি মিনিটের সীমার জন্য RateLimit-Limit, RateLimit-Remaining ও RateLimit-Reset, এবং মাসিক কোটার জন্য X-Quota-Limit, X-Quota-Remaining ও X-Quota-Reset থাকে। সীমা ছাড়িয়ে গেলে Retry-After সহ 429 পাবেন।

ডকুমেন্টেশন

• ডেভেলপার ড্যাশবোর্ড
• OpenAPI 3.1 বিবরণ
• MCP সার্ভার
• llms.txt: AI-এর জন্য সারসংক্ষেপ