API কী ও অ্যাক্সেস টোকেন

API কী দিয়েই আপনার প্রোগ্রাম LinkHarbor API-তে প্রবেশ করে। এটি কোনো ব্যক্তির নয়, একটি ওয়ার্কস্পেসের, আর স্কোপ দিয়ে আপনি যা অনুমতি দেন ঠিক ততটুকুই করতে পারে। আসল কলগুলোর জন্য আপনি কী-টি স্বল্পমেয়াদি একটি অ্যাক্সেস টোকেনে বদলে নেন।

#কে API কী তৈরি করতে পারেন?

• ওয়ার্কস্পেসের মালিক আর অ্যাডমিন – এডিটর আর ভিউয়াররা “কলব্যাক ও API”-এর অধীনে শুধু “সংযুক্ত অ্যাপ” কার্ড দেখেন
• Creator Pro থেকে; Creator Free-তে কার্ডে লেখা থাকে “API কী Creator Pro থেকে পাওয়া যায়।”
• একই সময়ে সক্রিয়: Creator Pro-তে সর্বোচ্চ ৫টি কী, Creator Agency-তে সর্বোচ্চ ২০টি, Enterprise-এ সর্বোচ্চ ৫০টি

সীমায় পৌঁছালে কী তৈরি করা 409 limit_reached দিয়ে ব্যর্থ হয়। আগে এমন একটি কী মুছুন যা আর দরকার নেই।

#API কী তৈরি করুন

1. নেভিগেশনে “কলব্যাক ও API” খুলুন
2. “API কী” কার্ডে “+ নতুন কী তৈরি করুন”-এ ক্লিক করুন
3. “নাম (ঐচ্ছিক)”-এ এমন একটি নাম দিন যা দিয়ে পরে কী-টি চিনবেন, যেমন “CI/CD পাইপলাইন” বা “শপ সিঙ্ক”
4. “স্কোপ”-এর অধীনে প্রতিটি অংশের জন্য “পড়া” বা “লেখা” বেছে নিন
5. “কী তৈরি করুন”-এ ক্লিক করুন
6. “কী সিক্রেট (গোপন)” সাথে সাথে কপি করে নিরাপদ জায়গায় রাখুন
7. ডায়ালগ বন্ধ করুন – কী আইডি যেকোনো সময় তালিকায় পাবেন

“নাম (ঐচ্ছিক)”

সর্বোচ্চ ৬৪ অক্ষর। নাম না দিলে কী-টি তালিকায় “API কী #ID” হিসেবে দেখা যায়।

“স্কোপ”

অন্তত একটি দরকার। “লেখা” একই অংশের জন্য স্বয়ংক্রিয়ভাবে “পড়া”-ও অন্তর্ভুক্ত করে। পরিসংখ্যান আর সমর্থকদের পেমেন্ট শুধু পড়া যায়, ওয়ার্কস্পেস টেমপ্লেট শুধু লেখা যায়। সব স্কোপ ব্যাখ্যা করা আছে স্কোপের বিস্তারিত-এ।

“কী সিক্রেট (গোপন)”

lt_ দিয়ে শুরু হয় এবং ঠিক একবারই দেখানো হয় (“⚠️ শুধু একবারই দেখা যাবে — এখনই কপি করুন!”)। LinkHarbor এর শুধু একটি হ্যাশ সংরক্ষণ করে, তাই পরে আর আপনাকে এটি দেখাতে পারে না।

“কী আইডি:”

অঙ্ক আর বড় হাতের A–F অক্ষর মিলিয়ে ১৬টি অক্ষর, যেমন 6F668EA6598B0692। এটি গোপন নয় এবং তালিকায় কপি বাটনসহ দেখা যায়।

#কী-এর তালিকা

প্রতিটি সক্রিয় কী-তে দেখা যায় তার নাম, “সক্রিয়” স্ট্যাটাস, কী আইডি, স্কোপ, “তৈরি হয়েছে:” আর “সর্বশেষ ব্যবহার:” বা “এখনো ব্যবহৃত হয়নি”। কী দিয়ে করা প্রতিটি কলে শেষ ব্যবহারের সময় আপডেট হয়, মিনিটে সর্বোচ্চ একবার। “↺ রিফ্রেশ” তালিকাটি আবার লোড করে।

#কী-এর বদলে অ্যাক্সেস টোকেন নিন

curl -X POST https://dock.at-harbor.com/v1/token \
  -H "Content-Type: application/json" \
  -d '{"key_id":"6F668EA6598B0692","key_secret":"lt_…"}'

{ "token": "eyJhbGciOiJIUzI1NiIs…", "expires_in": 900 }

token

অ্যাক্সেস টোকেন। প্রতিটি রিকোয়েস্টে এটি Authorization: Bearer <token> হিসেবে পাঠান।

expires_in

সেকেন্ডে মেয়াদ: 900, অর্থাৎ ১৫ মিনিট। কোনো রিফ্রেশ টোকেন নেই – মেয়াদ শেষ হলে কী আইডি আর সিক্রেট দিয়ে সহজেই নতুন টোকেন নিন।

টোকেনটি ওয়ার্কস্পেসের প্রতিনিধিত্ব করে এবং ঠিক কী-এর স্কোপগুলোই বহন করে। কোনো ব্যক্তির মতো এর কোনো রোল নেই: যেসব এন্ডপয়েন্ট ড্যাশবোর্ড মালিক আর অ্যাডমিনদের জন্য রাখে (সদস্য, বিলিং, ডোমেইন পরিচালনা, ওয়েবহুক, ওয়ার্কস্পেস সেটিংস), সেগুলো API কী থেকে আসা টোকেনের জন্য সবসময় প্রত্যাখ্যাত হয়। ব্যতিক্রম হলো শর্ট লিংক আর ওয়ার্কস্পেস টেমপ্লেট, যা মানানসই স্কোপ থাকলে কাজ করে, আর read:workspaces দিয়ে কলব্যাক সিক্রেট পড়া (প্লেইন-টেক্সট সিক্রেট ছাড়া)।

#ব্যর্থ চেষ্টা আর লকআউট

api_key_locked-এ বাকি সময় থাকে details.retry_after_sec-এ। একটি সফল বদল কাউন্টার আবার শূন্যে নিয়ে আসে।

#কী মুছুন ও বদলান

1. কী-এর পাশে “মুছুন”-এ ক্লিক করুন
2. নিশ্চিত করতে DELETE লিখুন
3. “স্থায়ীভাবে মুছুন”-এ ক্লিক করুন

কী-টি সাথে সাথে কাজ করা বন্ধ করে – আগে দেওয়া অ্যাক্সেস টোকেনও সেই মুহূর্ত থেকে কাজ করে না এবং 401 invalid_token পায়। কোনো রোটেট বাটন নেই। কী বদলাতে একটি নতুন কী তৈরি করুন, আপনার প্রোগ্রাম সেটিতে সরিয়ে নিন, তারপর পুরোনোটি মুছুন।

#প্ল্যান কমে গেলে

ওয়ার্কস্পেস Creator Free-তে গেলে সব API কী বাতিল হয়ে যায়। কম কী-এর কোনো প্ল্যানে গেলে সবচেয়ে নতুনগুলো থেকে যায় আর বাকিগুলো বাতিল হয়। বাতিল হওয়া কী পরে আপগ্রেড করলেও ফিরে আসে না – তখন নতুন কী তৈরি করবেন। মালিকরা বন্ধ হয়ে যাওয়া ফিচারের তালিকাসহ একটি ই-মেইল পান। আরও আছে বাতিল ও ডাউনগ্রেড-এ।

#নিরাপদে রাখা

• সিক্রেট শুধু সিক্রেটস ম্যানেজার বা এনভায়রনমেন্ট ভেরিয়েবলে রাখুন, কখনো সোর্স কোড বা Git রিপোজিটরিতে নয়
• ব্রাউজারে চলা কোডে বা ব্যবহারকারীর ডিভাইসের অ্যাপে কখনো এটি ব্যবহার করবেন না
• প্রতিটি অ্যাপ্লিকেশনের জন্য যত কম সম্ভব স্কোপসহ আলাদা কী তৈরি করুন
• যে কী আর দরকার নেই, তা সাথে সাথে মুছুন
• ফাঁস হওয়ার সন্দেহ হলে: কী-টি মুছে একটি নতুন কী তৈরি করুন