API কী দিয়ে অথেন্টিকেশন

দুটি মূল্য নির্ধারণ এন্ডপয়েন্ট ছাড়া প্রতিটি এন্ডপয়েন্টের জন্য Authorization হেডারে একটি API কী প্রয়োজন।

POST /v1/messages HTTP/1.1
Host: bulksmsapi.cc
Authorization: Bearer bsa_live_7QzX2mW9kR4tB8nV1cJ6yP3sH5dL0aFe
Content-Type: application/json

কী তৈরি করা

• কীগুলি কনসোলের API কী পৃষ্ঠায় তৈরি করা হয়। প্রথম টপ আপ ব্যালেন্সে যোগ করার পর পৃষ্ঠাটি খোলে।
• একটি অ্যাকাউন্ট 10টি সক্রিয় কী ধারণ করতে পারে। প্রতিটি অ্যাপ বা এনভায়রনমেন্টকে তার নিজস্ব কী এবং নাম দিন, যাতে একটি কী প্রতিস্থাপন করা যায় অন্যগুলি স্পর্শ না করে।
• একটি কী হল bsa_live_ এর পরে 32টি অক্ষর এবং সংখ্যা। এটি একবার দেখানো হয়, যখন এটি তৈরি করা হয়; আমরা শুধুমাত্র একটি কীড হ্যাশ সংরক্ষণ করি, তাই হারানো কী আবার দেখানো যায় না। পরিবর্তে একটি নতুন কী তৈরি করুন।
• তালিকাটি প্রথম অক্ষর, শেষ চারটি, কী কখন তৈরি হয়েছিল এবং কখন শেষ ব্যবহার হয়েছিল তা দেখায়।

ঘোরানো এবং বাতিল করা

ডাউনটাইম ছাড়াই একটি কী ঘোরানোর জন্য: একটি দ্বিতীয় কী তৈরি করুন, এটি ডিপ্লয় করুন, কনসোলে এর শেষ ব্যবহারের সময় চেক করুন, তারপর পুরানো কীটি বাতিল করুন। একটি বাতিল কী পরবর্তী অনুরোধ থেকে 401 unauthorized উত্তর দেয়।

কী নিরাপদে রাখা

• API কে আপনার সার্ভার থেকে কল করুন, ব্রাউজার বা মোবাইল অ্যাপ থেকে কখনই নয়: যে কেউ কীটি দিয়ে আপনার ব্যালেন্স থেকে মেসেজ পাঠাতে পারে।
• কীগুলি সোর্স কন্ট্রোলে নয়, এনভায়রনমেন্ট ভেরিয়েবল বা সিক্রেট ম্যানেজারে রাখুন।
• প্রতিটি কী এর নিজস্ব রেট লিমিট কাউন্টার আছে, তাই একটি ব্যস্ত ওয়ার্কার অন্য কোথাও ব্যবহৃত দ্বিতীয় কীকে ধীর করে না।

ত্রুটিসমূহ

{
  "error": {
    "code": "unauthorized",
    "message": "Send your API key as Authorization: Bearer bsa_live_... Keys are created in the console under API keys.",
    "doc_url": "https://bulksmsapi.cc/en/docs/errors#unauthorized"
  }
}