Partner API প্রমাণীকরণ: Bearer ec_live_ কী, রোটেশন ও 401 ত্রুটি
প্রতিটি Partner API রিকোয়েস্ট অ্যাকাউন্টের গোপন কীটি Authorization: Bearer ec_live_… হেডারে বহন করে, যা আপনার সার্ভার থেকে পাঠানো হয়। প্রতিটি easyCoexistence অ্যাকাউন্টের একটি কী থাকে, যা ড্যাশবোর্ডে Profile, Developers-এর অধীনে বা create_api_key চালাতে একটি AI সহকারীকে বলে তৈরি করা হয়, এবং শুধু একবারই দেখানো হয়। রোটেট করলে একটি নতুন কী ইস্যু হয় এবং পুরনোটি সঙ্গে সঙ্গে বন্ধ হয়; কী না থাকলে বা ভুল হলে 401 unauthorized ফেরত আসে।
প্রতিটি Partner API কী যে উপসর্গ দিয়ে শুরু হয়, যা প্রতিটি রিকোয়েস্টে Authorization: Bearer হিসেবে পাঠানো হয়।
একটি অ্যাকাউন্ট একসঙ্গে যতগুলো কী রাখতে পারে; এই কী দিয়ে করা প্রতিটি সংযোগ ওই অ্যাকাউন্টের।
কী নেই বা অবৈধ হলে স্ট্যাটাস, ত্রুটির কোড unauthorized এবং প্রত্যাশিত হেডারের নাম উল্লেখ করা একটি মেসেজ।
কখন পুরো কী দেখানো হয়: তৈরি বা রোটেট করার সময়; এরপর শুধু প্রথম কয়েকটি অক্ষর দেখা যায়।
একটি রিকোয়েস্ট কীভাবে প্রমাণিত হয়?
https://easycoexistence.com/api/v1-এর প্রতিটি রিকোয়েস্টে কীটি Authorization হেডারে Bearer টোকেন হিসেবে পাঠাতে হয়। অন্য কিছু সাইন বা স্কোপ করা হয় না: কী অ্যাকাউন্টটিকে শনাক্ত করে, আর রিকোয়েস্টটি যা তৈরি করে বা পড়ে তা সবই ওই অ্যাকাউন্টের। বডি JSON, এবং প্রতিটি ত্রুটি কোড ও মেসেজসহ একটি অবজেক্ট হিসেবে ফেরত আসে।
curl https://easycoexistence.com/api/v1/connections \
-H "Authorization: Bearer $EC_API_KEY"কোথায় কী তৈরি করবেন?
ড্যাশবোর্ড থেকে বা একটি AI সহকারী দিয়ে, ফলাফল একই। ড্যাশবোর্ডে Profile খুলুন, তারপর Developers-এ যান এবং Create API key চাপুন। Claude, ChatGPT বা easyCoexistence-এর MCP সার্ভারের সঙ্গে সংযুক্ত অন্য কোনো সহকারীকে বলুন Partner API সেট আপ করতে: get_partner_setup দেখায় কী বাকি আছে, আর create_api_key কী ফেরত দেয়। দুই পদ্ধতিতেই পুরো কী একবারই দেখানো হয়, তাই এটি সঙ্গে সঙ্গে আপনার ব্যাকএন্ডের গোপন তথ্যের স্টোরে রাখুন।
কী কেন একবারই দেখানো হয়?
কারণ শুধু এর একটি হ্যাশ সংরক্ষণ করা হয়। easyCoexistence প্রতিটি রিকোয়েস্ট যাচাই করতে হ্যাশটি রাখে, পাশাপাশি কীটির প্রথম অক্ষরগুলো, অর্থাৎ ec_live_ ও আরও ছয়টি অক্ষর, রাখে, যাতে ড্যাশবোর্ড দেখাতে পারে কোন কীটি সক্রিয় এবং কখন তৈরি হয়েছে। হারিয়ে যাওয়া কী আবার দেখানো যায় না; রোটেট করলে সেটি প্রতিস্থাপিত হয়।
কীটি কীভাবে রোটেট বা বাতিল করবেন?
এক ধাপে, এবং পুরনো কী সেই মুহূর্ত থেকেই কাজ বন্ধ করে, কোনো অতিরিক্ত সময় ছাড়াই, কারণ কী ফাঁস হওয়াই সাধারণত রোটেট করার কারণ। নতুন কীটি প্রথমবারের মতোই একবার দেখানো হয়:
- ড্যাশবোর্ড: Profile, Developers, Rotate key।
- MCP:
create_api_key,replace_existing-কে true সেট করে। এটি না দিলে কী থাকা অবস্থায় টুলটি কাজ করতে অস্বীকার করে, তাই চালু থাকা ইন্টিগ্রেশন দুর্ঘটনাবশত ভাঙে না। - সব অ্যাক্সেস বন্ধ করতে বাতিল করুন: ড্যাশবোর্ডে Revoke, অথবা
revoke_api_key, confirm-কে true সেট করে। এরপর নতুন কী তৈরি না হওয়া পর্যন্ত রিকোয়েস্ট ব্যর্থ হয়।
কী না থাকলে বা ভুল হলে কী ফেরত আসে?
401 ফেরত আসে, ত্রুটির কোড unauthorized সহ, যখন রিকোয়েস্টে Authorization হেডার নেই, কী ec_live_ দিয়ে শুরু হয় না, অথবা কীটি রোটেট বা বাতিল হয়ে গেছে। মেসেজটি যে হেডার প্রত্যাশা করে তার নাম উল্লেখ করে। যখন একটি ঠিকানা থেকে ব্যর্থ রিকোয়েস্ট ক্রমাগত আসতে থাকে, API তার বদলে 429 rate_limited দিয়ে উত্তর দেয়, সঙ্গে আবার চেষ্টার আগে অপেক্ষার সেকেন্ড।
{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key. Send `Authorization: Bearer ec_live_...`."
}
}একটি বৈধ কীও আর কী কারণে প্রত্যাখ্যান হতে পারে?
বৈধ কী অ্যাকাউন্টকে শনাক্ত করে, তবে অ্যাকাউন্টের অবস্থাও প্রযোজ্য থাকে। এগুলো একই ত্রুটির কাঠামোতে ফেরত আসে:
- 402
billing_required: অ্যাকাউন্টে এখনো কার্ড নেই, তাই এটি কানেক্ট সেশন শুরু করতে পারে না। - 404
not_found: আইডিটি এই অ্যাকাউন্টের কোনো সংযোগ, চ্যানেল বা সেশনের সঙ্গে মেলে না, অন্য অ্যাকাউন্টের ক্ষেত্রেও। - 409 removed: সংযোগটি সরিয়ে ফেলা হয়েছে, তাই এর ওয়েবহুক আর বদলানো যায় না।
- 402 suspended: সাবস্ক্রিপশন মেয়াদ শেষ হওয়ায় সংযোগটি স্থগিত; আগে এটি পুনরায় সংযুক্ত করুন।
- 429
cap_reachedবাrate_limited: একসঙ্গে অনেক বেশি খোলা কানেক্ট সেশন, অথবা এই ঘণ্টায় অনেক বেশি তৈরি।
সাধারণ ভুলগুলো
- ফ্রন্টএন্ড কোডে কী রাখা। পেজ যে কেউ খুললে তা পড়তে পারে, আপনার খরচে সংযোগ তৈরি করতে পারে এবং ?credentials=1 দিয়ে আপনার গ্রাহকদের টোকেন আনতে পারে।
- ব্যাকএন্ড নতুন কী নেওয়ার আগে রোটেট করা। পুরনো কী সঙ্গে সঙ্গে বন্ধ হয়, তাই নতুনটি ডিপ্লয় না হওয়া পর্যন্ত প্রতিটি রিকোয়েস্ট 401 দিয়ে ব্যর্থ হয়।
- এমন একটি কথোপকথনে কী তৈরি করা যা আপনি শেয়ার করেন। create_api_key কীটি চ্যাটেই ফেরত দেয়, যেখানে সেটি ইতিহাসে থেকে যায়, তাই কথোপকথনটি শেয়ার হয়ে থাকলে রোটেট করুন।
- কীটি উদ্ধৃতি চিহ্নের মধ্যে সংরক্ষণ করা। Bearer-এর পরের সবকিছুকে কী হিসেবে পড়া হয়, তাই উদ্ধৃত মান কখনো মেলে না এবং প্রতিটি রিকোয়েস্ট 401 পায়।
easyCoexistence প্রতি অ্যাকাউন্টে একটি Partner API কী দেয়, যাতে আপনার ব্যাকএন্ড আপনার গ্রাহকদের WhatsApp নম্বর এবং তাদের Instagram, Facebook, TikTok, YouTube ও LinkedIn অ্যাকাউন্ট, এবং আরও চ্যানেল, সংযুক্ত করতে পারে, তারপর প্রতিটি সংযোগের ক্রেডেনশিয়াল পড়তে ও ইভেন্ট রুট করতে পারে। প্রতি সংযোগ মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ার সঙ্গে কমে, প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
একটি অ্যাকাউন্টে কি একাধিক Partner API কী থাকতে পারে?
না। একটি অ্যাকাউন্টে একবারে একটিই কী থাকে, নতুন কী তৈরি করলে সেটি আগেরটির জায়গা নেয়। আলাদা কী মানে আলাদা easyCoexistence অ্যাকাউন্ট, যার প্রতিটির নিজস্ব সংযোগ ও নিজস্ব বিল।
Partner API কী কি মেয়াদোত্তীর্ণ হয়?
না। কীটি রোটেট বা বাতিল না হওয়া পর্যন্ত, অথবা Meta-র নিয়ম লঙ্ঘনের অপব্যবহারের কারণে easyCoexistence এটি বন্ধ না করা পর্যন্ত কাজ করে।
সংযুক্ত হতে কি আমার গ্রাহকদের আমার কী লাগবে?
না। তারা শুধু হোস্ট করা কানেক্ট লিংক খোলে, যার নিজস্ব সেশন আইডি থাকে। কীটি আপনার সার্ভারে থাকে এবং শুধু আপনার ব্যাকএন্ড ব্যবহার করে।
API কী কি ইভেন্ট সাইন করার সিক্রেটের সমান?
না। কীটি API-তে আপনার রিকোয়েস্ট প্রমাণ করে। সাইনিং সিক্রেট, যা স্ট্যাটাস ইভেন্ট URL সেট করার সময় একবার দেখানো হয়, আপনার এন্ডপয়েন্টকে easyCoexistence-এর পাঠানো ইভেন্ট যাচাই করতে দেয়।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে