> ## Documentation Index
> Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt
> Use this file to discover all available pages before exploring further.

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

> একটি API কী তৈরি করুন এবং REST API, CLI বা MCP সার্ভার থেকে X-API-Key হেডার হিসেবে পাঠান। MCP ক্লায়েন্ট OAuth (PKCE) দিয়েও সংযুক্ত হতে পারে।

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

REST API রিকোয়েস্ট `X-API-Key` হেডারের মাধ্যমে পাঠানো একটি API কী ব্যবহার করে। MCP ক্লায়েন্ট একটি API কী অথবা ব্যবহারকারীর অনুমোদিত OAuth (PKCE) ব্যবহার করতে পারে।

AI এজেন্টরা OAuth ডিসকভারি, ক্লায়েন্ট রেজিস্ট্রেশন, ব্যবহারকারীর সম্মতি, টোকেন রিফ্রেশ এবং CLI API কী প্রভিশনিংয়ের জন্য [Auth.md](https://so-me.studio/auth.md) দিয়ে শুরু করতে পারে।

```bash theme={null}
X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxx
```

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

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

[Social media studio](https://so-me.studio)-তে গিয়ে লগ ইন করুন।

**2. API সেটিংস খুলুন**

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

**3. নতুন কী তৈরি করুন**

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

**4. অ্যাক্সেস বেছে নিন**

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

**5. কী কপি করুন**

**তৈরি করুন**-এ ক্লিক করে কীটি কপি করুন।

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

## অনুমতি

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

## Scopes

তৈরির সময় স্কোপ না দিলে একটি কী-র **সম্পূর্ণ অ্যাক্সেস** থাকে। স্কোপ চালু হওয়ার আগে তৈরি প্রতিটি কী সম্পূর্ণ অ্যাক্সেসই বজায় রাখে।

স্কোপযুক্ত একটি কী শুধু সেই এন্ডপয়েন্টগুলোই কল করতে পারে যেগুলো তার স্কোপের আওতায় পড়ে। অন্য যেকোনো এন্ডপয়েন্ট বার্তায় অনুপস্থিত স্কোপের নামসহ `403 Forbidden` ফেরত দেয়।

* `GET` এন্ডপয়েন্টের জন্য `<resource>:read` লাগে।
* `POST`, `PUT`, `PATCH` বা `DELETE` এন্ডপয়েন্টের জন্য `<resource>:write` লাগে।
* `<resource>:write`-এর মধ্যে `<resource>:read` অন্তর্ভুক্ত।

| রিসোর্স | স্কোপ | এন্ডপয়েন্ট |
| - | - | - |
| `accounts` | `accounts:read`, `accounts:write` | `/v1/accounts` |
| `posts` | `posts:read`, `posts:write` | `/v1/posts`, `/v1/drafts`, `/v1/approvals` |
| `media` | `media:read`, `media:write` | `/v1/media` |
| `analytics` | `analytics:read` | `/v1/analytics` |
| `inbox` | `inbox:read`, `inbox:write` | `/v1/inbox` |
| `ai` | `ai:read`, `ai:write` | `/v1/ai` |
| `biolinks` | `biolinks:read`, `biolinks:write` | `/v1/biolinks` |
| `teams` | `teams:read`, `teams:write` | `/v1/teams` |
| `settings` | `settings:read`, `settings:write` | `/v1/settings` (নিচের ব্যতিক্রমগুলো দেখুন) |
| `webhooks` | `webhooks:read`, `webhooks:write` | `/v1/webhooks` |
| `support` | `support:read`, `support:write` | `/v1/support` |
| `templates` | `templates:read` | `/v1/templates` |
| `whatsapp` | `whatsapp:read`, `whatsapp:write` | `/v1/whatsapp` |

ব্যতিক্রম:

* `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` পাঠান:

```bash theme={null}
curl https://api.so-me.studio/v1/settings/api-keys \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"name": "Zapier", "scopes": ["accounts:read", "posts:write", "media:write"]}'
```

সম্পূর্ণ অ্যাক্সেসের কী চাইলে `scopes` বাদ দিন। একটি কী-র স্কোপ বদলানো যায় না। কীটি বাতিল করে নতুন একটি তৈরি করুন।

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

### REST API

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

```bash theme={null}
curl https://api.so-me.studio/v1/posts \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
```

### MCP সার্ভার

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

```json theme={null}
{
  "mcpServers": {
    "so-me-studio": {
      "url": "https://api.so-me.studio/mcp",
      "headers": {
        "X-API-Key": "sk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
```

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

REST API, CLI ও MCP অ্যাক্সেস **Standard**, **Advanced** ও **Lifetime** প্ল্যানে পাওয়া যায়। **Lite** প্ল্যানে API, CLI বা MCP অ্যাক্সেস নেই।

| প্ল্যান | API অ্যাক্সেস |
| - | - |
| Lite | না |
| Standard | হ্যাঁ |
| Advanced | হ্যাঁ |
| Lifetime | হ্যাঁ |

প্ল্যানের বিস্তারিত জানতে [বিলিং ওভারভিউ](/bn/billing/overview.md) দেখুন।

## রেট লিমিট

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

MCP টুল কলও আপনার প্ল্যান অনুযায়ী ক্রেডিট খরচ করে। ব্যবহার দেখতে **সেটিংস** > **API** দেখুন, আর ক্রেডিট কীভাবে কাজ করে তা জানতে [AI ক্রেডিট](/bn/get-started/ai-credits.md) দেখুন।

> [!NOTE]
>
> উচ্চতর প্ল্যানে বেশি রেট লিমিট এবং মাসিক API ব্যবহারের সুবিধা মেলে। আপনার প্ল্যানে কোন সীমা প্রযোজ্য তা জানতে [বিলিং ওভারভিউ](/bn/billing/overview.md) দেখুন।


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.