跳转到内容

প্রমাণীকরণ এবং API কীসমূহ

একটি কী তৈরি করুন

Section titled “একটি কী তৈরি করুন”

API কেন্দ্র -এ sk_ API কী তৈরি করুন। সম্পূর্ণ কীটি শুধুমাত্র একবারই প্রদর্শিত হয়, যখন এটি তৈরি বা রোটেট করা হয়।

প্রতিটি অ্যাপ্লিকেশন, পরিবেশ এবং স্বয়ংক্রিয় কাজের জন্য আলাদা কী ব্যবহার করুন, যাতে প্রতিটির নিজস্ব বাজেট থাকতে পারে এবং সেগুলো স্বতন্ত্রভাবে নিষ্ক্রিয় করা, পরিবর্তন করা এবং নিরীক্ষণ করা যায়।

শংসাপত্র প্রেরণ করুন

Section titled “শংসাপত্র প্রেরণ করুন”

প্রস্তাবিত:

X-API-Key: sk_your_key

স্ট্যান্ডার্ড Bearer ফর্মটিও কাজ করে:

Authorization: Bearer sk_your_key

একটি অনুরোধে এই দুটির মধ্যে কেবল একটি পাঠান।

Terminal window
curl https://omnidoc.top/api/v1/jobs \
-H "X-API-Key: $OMNIDOC_API_KEY"

একটি কী কী প্রতিনিধিত্ব করে

Section titled “একটি কী কী প্রতিনিধিত্ব করে”

একটি কী তার যে অ্যাকাউন্ট দ্বারা তৈরি করা হয়েছে, সেই অ্যাকাউন্টের জন্যই কার্যকর হয়: এটি শুধুমাত্র সেই অ্যাকাউন্টের ব্যবহারযোগ্য পরিষেবাগুলিকে কল করতে পারে এবং কেবল সেই অ্যাকাউন্টের সংস্থানগুলিতেই পৌঁছাতে পারে। একটি কী লগইন ইমেল, পাসওয়ার্ড, ফোন নম্বর বা প্রোফাইল পরিবর্তন করতে পারে না এবং API কী তৈরি, ঘূর্ণন বা বাতিল করতে পারে না।

ঐচ্ছিক সীমাঃ

  • allowed_engines: শুধুমাত্র তালিকাভুক্ত অনুবাদের সেটিংস; একটি খালি অ্যারে কোনো কী-স্তরের সীমা যোগ করে না।
  • expires_at: মেয়াদ শেষের সময়।
  • quota_limit: মোট মিলিক্রেডিটে কী-এর জীবনকালের বাজেট; 0 কোনো কী-স্তরের বাজেট নির্ধারণ করে না, এবং অ্যাকাউন্টের ক্রেডিটগুলি স্বাভাবিকভাবেই নিষ্পত্তি করা হয়।

ঘূর্ণন এবং বাতিলকরণ

Section titled “ঘূর্ণন এবং বাতিলকরণ”

API কেন্দ্রে তাদের সীমা পরিবর্তন করুন, ঘূর্ণন করুন বা বাতিল করুন । একবার কোনো কী বাতিল হলে, নিষ্ক্রিয় করা হলে বা মেয়াদ শেষ হলে, অথবা তার অ্যাকাউন্ট নিষ্ক্রিয় করা হলে, নতুন অনুরোধগুলি তৎক্ষণাৎ ব্যর্থ হয়।

রোটেশন একটি নতুন সিক্রেট তৈরি করে এবং একই সাথে পুরোনোটিকে অক্ষম করে; নতুন কী আগের সীমা এবং ইতোমধ্যে ব্যবহৃত বাজেট ধরে রাখে। মেয়াদোত্তীর্ণ কী রোটেট করা যায় না; এর পরিবর্তে একটি নতুন কী তৈরি করুন। নির্বিঘ্নে সুইচ করার জন্য, একটি নতুন কী তৈরি করে তা ডেপ্লয় করুন, কলগুলি সফল হওয়ার বিষয়টি নিশ্চিত করুন, এরপর পুরোনো কীটি বাতিল করুন।

  • কীগুলি কেবলমাত্র সার্ভারে বা নিয়ন্ত্রিত রানটাইমে রাখুন।
  • পরিবেশ ভেরিয়েবল বা সিক্রেট ম্যানেজার ব্যবহার করুন; কোনো অবস্থাতেই কীগুলো সোর্স কোড, লগ, ব্রাউজার বান্ডেল বা পাবলিক রিপোজিটরিতে রাখবেন না।
  • API দ্বারা ফেরত দেওয়া আপলোড বা ডাউনলোডের ঠিকানায় কখনোই কী প্রেরণ করবেন না।
  • কী আইডি, অনুরোধ আইডি এবং অপারেশন আইডি লগ করুন; সম্পূর্ণ কী কখনও লগ করবেন না।
  • যদি কোনো কী ফাঁস হয়, তবে সঙ্গে সঙ্গে এটিকে পরিবর্তন করুন এবং এর কাজ ও চার্জগুলো পর্যালোচনা করুন।