অথেনটিকেশন

প্রতিটি রিকোয়েস্ট Authorization হেডারে একটা bearer টোকেন বহন করে। স্কোপ ঠিক করে একটা টোকেন কী করতে পারবে।

1. Bearer টোকেন

   তোমার কী “Authorization: Bearer …” হিসেবে পাঠাও। বৈধ কী ছাড়া তুমি 401 পাবে।

2. Scopes

   টোকেন শুধু সেই স্কোপগুলোই পায় যা তুমি বেছেছ। এর বাইরের রিকোয়েস্ট 403 ফেরত দেয়।

3. টেস্ট আর লাইভ

   টেস্ট কী কখনও আসল ডেটা ছোঁয় না। তৈরি হলে লাইভে সুইচ করো।

4. সীমা, আর তুমি কোনো সীমা পেরোলে কী হয়

   প্রতিটি কী-এর জন্য দুটি সীমা আছে: একটি প্রতি মিনিটে আর একটি প্রতি দিনে। এর যেকোনো একটি পার হলেই তুমি Retry-After হেডারসহ একটি 429 পাবে, যা বলে দেয় কতক্ষণ অপেক্ষা করতে হবে — বার্তাটি তোমাকে জানায় তুমি কোন সীমাটি ছুঁয়েছ। যে কী দিনের পর দিন তার সীমায় আটকে থাকে, সেটি একজন মানুষ দেখেন এবং সাময়িকভাবে বন্ধ করে দেওয়া হতে পারে; তখন তুমি কারণসহ একটি 403 পাবে, যাতে বুঝতে পারো সমস্যাটা আমাদের দিকে, তোমার কী-তে নয়।