API কী (Developers পৃষ্ঠা)

🌐 এই অনুবাদ কমিউনিটি পর্যালোচনার অধীনে। কোনো ভুল বা অস্বাভাবিক বাক্যবিন্যাস লক্ষ্য করেছেন? নিচের GitHub-এ এই পাতা সম্পাদনা করুন ক্লিক করে উন্নতি প্রস্তাব করুন।

আপনি যদি Quran Gallery-র উপর কিছু তৈরি করছেন — সাইড প্রোজেক্ট, ব্যক্তিগত ড্যাশবোর্ড, অটোমেশন স্ক্রিপ্ট — তবে আপনি ব্যক্তিগত API কী তৈরি করতে পারেন যা প্রমাণ করে অনুরোধটি আপনার থেকে এসেছে, ব্রাউজার সেশন ছাড়াই।

API কী সম্পূর্ণরূপে আপনার অ্যাকাউন্টের Developers পৃষ্ঠা থেকে পরিচালিত হয়।

Developers পৃষ্ঠায় কীভাবে পৌঁছাবেন

accounts.qurangallery.com এ সাইন ইন করুন, তারপর accounts.qurangallery.com/developers এ যান।

API কী কী

একটি API কী হলো লম্বা গোপন স্ট্রিং যা দেখায়:

qg_abc123def456...

qg_ প্রিফিক্স এটিকে Quran Gallery কী হিসেবে চিহ্নিত করে। যখন আপনি এটি Quran Gallery-তে অনুরোধের Authorization: Bearer ... হেডারে পাঠান, সার্ভার অনুরোধটিকে এমনভাবে আচরণ করে যেন আপনি এটি করেছেন। সুতরাং একটি API কী কার্যকরভাবে আপনার অ্যাকাউন্টের পাসওয়ার্ড যা প্রোগ্রাম্যাটিক ব্যবহারে স্কোপড — এটিকে এমনই গণ্য করুন।

একটি কী তৈরি

1. Developers পৃষ্ঠায় Create New Key কার্ড খুঁজুন।
2. একটি বর্ণনামূলক নাম লিখুন — "Madrasah progress export script", "My Raspberry Pi dashboard", "Local dev"। নাম শুধু আপনার জন্য।
3. Create key ক্লিক করুন।

নতুন কী পৃষ্ঠার শীর্ষে একটি সবুজ কার্ডে এর পূর্ণ মান সহ প্রদর্শিত হয়। এটিই একমাত্র সময় যখন আপনি পূর্ণ কী দেখবেন। কপি আইকনে ক্লিক করে এটি ক্লিপবোর্ডে রাখুন, তারপর সুরক্ষিত জায়গায় সংরক্ষণ করুন।

আপনি Done ক্লিক করার পর সবুজ কার্ড অদৃশ্য হয়ে যায়, এবং সেই মুহূর্ত থেকে কী-এর শুধু প্রথম কয়েকটি অক্ষর (“start”) কী তালিকায় দৃশ্যমান। পূর্ণ মান আবার পুনরুদ্ধার করার কোনও উপায় নেই — হারিয়ে ফেললে নতুন কী তৈরি করতে এবং পুরানোটি মুছে ফেলতে হবে।

কী তালিকা

তৈরি ফর্মের নিচে, আপনি আপনার অ্যাকাউন্টে বর্তমানে থাকা প্রতিটি কী দেখতে পান।

প্রতিটি কী-এর জন্য:

• নাম — আপনি তৈরির সময় যা লিখেছেন।
• স্ট্যাটাস — Active (সবুজ পিল) বা Disabled (ধূসর পিল)।
• Start — কী-এর প্রথম কয়েকটি অক্ষর, যেমন qg_abc12...।
• Created — কী তৈরির তারিখ।

প্রতিটি সারির ডানে, ট্র্যাশ আইকন কী মুছে দেয়। মুছে ফেলা স্থায়ী এবং তাৎক্ষণিক — মুছে দেওয়া কী ব্যবহার করা কোনও স্ক্রিপ্ট বা অ্যাপ তার পরবর্তী অনুরোধে 401 Unauthorized পেতে শুরু করে।

কী ব্যবহার

Authorization হেডারে পাঠান:

Authorization: Bearer qg_abc123def456...

Developers পৃষ্ঠার ব্যবহার কার্ড অনুলিপি করতে সঠিক ফরম্যাট দেখায়। একই কী Quran Gallery-র প্রতিটি সেবায় যা কী প্রমাণীকরণ সমর্থন করে আপনাকে প্রমাণীকরণ করে।

API-কী অনুরোধ ব্রাউজার সেশন এড়িয়ে যায়, তাই আপনি CI জব, নির্ধারিত কাজ, মোবাইল অ্যাপ থেকে ব্যবহার করতে পারেন।

রেট সীমা

প্রতিটি API কী প্রতি মিনিটে 60 অনুরোধ, স্লাইডিং উইন্ডোতে সীমাবদ্ধ। ব্যক্তিগত ব্যবহার এবং অধিকাংশ স্ক্রিপ্টের জন্য যথেষ্ট। অতিক্রম করলে API HTTP 429 ফেরায়।

স্থগিত বা মুছে ফেলা অ্যাকাউন্টের API কী অবিলম্বে কাজ করা বন্ধ করে।

কী ঘোরানো

সর্বোত্তম অভ্যাস হলো কী ঘোরানো যখনই:

• কী সহ একটি ল্যাপটপ বা ডিভাইস হারিয়ে গেছে বা বিক্রি হয়েছে।
• আপনি কী একটি সহযোগীর সাথে ভাগ করেছেন যিনি আর অ্যাক্সেস চান না।
• অনেক সময় হয়ে গেছে এবং আপনি একটি অন-ঘূর্ণিত গোপন রাখতে চান না।

ঘোরানো একটি দুই-পদক্ষেপ ম্যানুয়াল প্রবাহ:

1. একটি বর্ণনামূলক নাম দিয়ে একটি নতুন কী তৈরি করুন।
2. নতুন কী ব্যবহার করতে আপনার স্ক্রিপ্ট/অ্যাপ আপডেট করুন।
3. সবকিছু নতুন কী-তে গেলে পুরানোটি মুছে ফেলুন।

স্বয়ংক্রিয় ঘোরানো ফিচার আজ নেই।

আমি আমার কী হারিয়েছি

Quran Gallery হারানো কী পুনরুদ্ধার করতে পারে না। তালিকা থেকে পুরানো কী মুছে ফেলুন এবং একটি নতুন তৈরি করুন। নতুন মান ব্যবহার করতে আপনার স্ক্রিপ্ট আপডেট করুন।

নিরাপত্তা চেকলিস্ট

• কখনও কী git-এ কমিট করবেন না। একটি .env ফাইল ব্যবহার করুন (এবং .gitignore এ যোগ করুন)।
• কখনও কী পাবলিক Slack, Discord, GitHub ইস্যু, বা AI টুলের সাথে চ্যাটে পেস্ট করবেন না।
• প্রতি প্রকল্পে একটি কী ব্যবহার করুন, সব কিছুর জন্য একটি নয়।
• যদি কী আপোসকৃত বলে সন্দেহ হয়, প্রথমে মুছুন, তারপর নতুন তৈরি করুন। ক্রম গুরুত্বপূর্ণ।
• ক্লায়েন্ট-সাইড কোডে কী বেক করবেন না (ব্যবহারকারীর ব্রাউজারে চালানো JavaScript, মোবাইল-অ্যাপ বাইনারি)।

সাধারণ ত্রুটি