Skip to main content

API কী অথেনটিকেশন

REST API রিকোয়েস্ট X-API-Key হেডারের মাধ্যমে পাঠানো একটি API কী ব্যবহার করে। MCP ক্লায়েন্ট একটি API কী অথবা ব্যবহারকারীর অনুমোদিত OAuth (PKCE) ব্যবহার করতে পারে। AI এজেন্টরা OAuth ডিসকভারি, ক্লায়েন্ট রেজিস্ট্রেশন, ব্যবহারকারীর সম্মতি, টোকেন রিফ্রেশ এবং CLI API কী প্রভিশনিংয়ের জন্য Auth.md দিয়ে শুরু করতে পারে।

API কী তৈরি করুন

1

আপনার ড্যাশবোর্ডে লগ ইন করুন

Social media studio-তে গিয়ে লগ ইন করুন।
2

API সেটিংস খুলুন

সেটিংস > API ট্যাবে যান।
3

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

নতুন API কী-তে ক্লিক করে একটি নাম দিন।
4

অ্যাক্সেস বেছে নিন

সম্পূর্ণ অ্যাক্সেস রাখুন, অথবা সীমিত বেছে নিয়ে প্রতিটি রিসোর্স অ্যাক্সেস নেই, পড়া বা পড়া ও লেখা হিসেবে ঠিক করুন। Scopes দেখুন।
5

কী কপি করুন

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

অনুমতি

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

Scopes

তৈরির সময় স্কোপ না দিলে একটি কী-র সম্পূর্ণ অ্যাক্সেস থাকে। স্কোপ চালু হওয়ার আগে তৈরি প্রতিটি কী সম্পূর্ণ অ্যাক্সেসই বজায় রাখে। স্কোপযুক্ত একটি কী শুধু সেই এন্ডপয়েন্টগুলোই কল করতে পারে যেগুলো তার স্কোপের আওতায় পড়ে। অন্য যেকোনো এন্ডপয়েন্ট বার্তায় অনুপস্থিত স্কোপের নামসহ 403 Forbidden ফেরত দেয়।
  • GET এন্ডপয়েন্টের জন্য <resource>:read লাগে।
  • POST, PUT, PATCH বা DELETE এন্ডপয়েন্টের জন্য <resource>:write লাগে।
  • <resource>:write-এর মধ্যে <resource>:read অন্তর্ভুক্ত।
ব্যতিক্রম:
  • POST /v1/media/validate-এর জন্য শুধু media:read লাগে, কারণ এটি কিছুই বদলায় না।
  • POST /v1/templates/{id}/render-এর জন্য শুধু templates:read লাগে।
  • এই এন্ডপয়েন্টগুলোর জন্য সম্পূর্ণ অ্যাক্সেসের কী লাগে: PATCH /v1/settings/profile, /v1/settings/api-keys-এর সবগুলো এবং /v1/settings/tenants-এর সবগুলো। স্কোপযুক্ত কী দিয়ে নতুন কী তৈরি করা বা অন্য ওয়ার্কস্পেসে পৌঁছানো যায় না।
  • MCP সার্ভার স্কোপযুক্ত কী গ্রহণ করে না। সম্পূর্ণ অ্যাক্সেসের কী ব্যবহার করুন অথবা OAuth দিয়ে সংযুক্ত হোন।
  • teams:write দিয়ে মালিক (owner) আমন্ত্রণ বা পদোন্নতি দেওয়া যায় না। শুধু সম্পূর্ণ অ্যাক্সেসের কী owner রোল দিতে পারে।
  • স্কোপযুক্ত একটি কী শুধু সেই ওয়েবহুক ইভেন্টগুলোতেই সাবস্ক্রাইব, সেগুলোর তালিকা দেখা এবং পুনরায় চেষ্টা (retry) করতে পারে যেগুলো সে পড়তে পারে। যেমন, inbox ইভেন্টের জন্য inbox:read এবং post, draft ও approval ইভেন্টের জন্য posts:read লাগে। knowledge, organization, account, auth, api_key, integration, subscription, referral, mcp ও quota ইভেন্টের জন্য সম্পূর্ণ অ্যাক্সেসের কী লাগে।
API-র মাধ্যমে স্কোপযুক্ত কী তৈরি করতে, সম্পূর্ণ অ্যাক্সেসের একটি কী দিয়ে POST /v1/settings/api-keys-এ scopes পাঠান:
সম্পূর্ণ অ্যাক্সেসের কী চাইলে scopes বাদ দিন। একটি কী-র স্কোপ বদলানো যায় না। কীটি বাতিল করে নতুন একটি তৈরি করুন।

আপনার API কী ব্যবহার

REST API

কীটি X-API-Key হেডারে পাঠান:

MCP সার্ভার

MCP সার্ভার একই API কী ব্যবহার করে। এটি শুধু সম্পূর্ণ অ্যাক্সেসের কী গ্রহণ করে। আপনার MCP কনফিগারেশনের X-API-Key হেডারে কীটি দিন:

প্ল্যানের শর্ত

REST API, CLI ও MCP অ্যাক্সেস Standard, Advanced ও Lifetime প্ল্যানে পাওয়া যায়। Lite প্ল্যানে API, CLI বা MCP অ্যাক্সেস নেই। প্ল্যানের বিস্তারিত জানতে বিলিং ওভারভিউ দেখুন।

রেট লিমিট

API রিকোয়েস্টের রেট লিমিট ওয়ার্কস্পেস অনুযায়ী প্রযোজ্য, এবং সুনির্দিষ্ট সীমা আপনার প্ল্যান অনুযায়ী নির্ধারিত হয়। সীমা ছাড়ালে আপনি 429 Too Many Requests রেসপন্স পাবেন — সময়সীমা রিসেট হওয়া পর্যন্ত অপেক্ষা করে আবার চেষ্টা করুন। MCP টুল কলও আপনার প্ল্যান অনুযায়ী ক্রেডিট খরচ করে। ব্যবহার দেখতে সেটিংস > API দেখুন, আর ক্রেডিট কীভাবে কাজ করে তা জানতে AI ক্রেডিট দেখুন।
উচ্চতর প্ল্যানে বেশি রেট লিমিট এবং মাসিক API ব্যবহারের সুবিধা মেলে। আপনার প্ল্যানে কোন সীমা প্রযোজ্য তা জানতে বিলিং ওভারভিউ দেখুন।