> ## 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 কলে Instagram, LinkedIn, X, TikTok ও আরও অনেক জায়গায় আপনার প্রথম পোস্ট শিডিউল করুন। পোস্ট ও মিডিয়ার কাজ-করা curl উদাহরণ।

## পূর্বশর্ত

শুরু করার আগে নিশ্চিত করুন যে আপনার কাছে আছে:

1. অন্তত একটি সংযুক্ত সোশ্যাল অ্যাকাউন্টসহ একটি Social media studio অ্যাকাউন্ট
2. একটি API কী ([অথেনটিকেশন](/bn/authentication.md) দেখুন)

## বেস URL

সব API রিকোয়েস্ট পাঠাতে হবে এই ঠিকানায়:

```
https://api.so-me.studio/v1
```

## পোস্ট তৈরি করুন

নতুন পোস্ট তৈরি করতে একটি `POST` রিকোয়েস্ট পাঠান:

```bash theme={null}
curl -X POST https://api.so-me.studio/v1/posts \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello from the API!",
    "socialMedia": "TWITTER",
    "postType": "TEXT"
  }'
```

> [!NOTE]
>
> `socialMedia` ১৬টি পাবলিশিং গন্তব্যের যেকোনোটি গ্রহণ করে (যেমন `TWITTER`,
> `LINKEDIN`, `INSTAGRAM`, `FACEBOOK`, `TIKTOK`, `YOUTUBE`, `THREADS`,
> `PINTEREST`, `BLUESKY` ও আরও) — শুধু এই উদাহরণগুলোতে দেখানোগুলো নয়।
> `WHATSAPP` ও `TELEGRAM` শুধু মেসেজিংয়ের জন্য, এগুলোতে পোস্ট করা যায় না।
> সমর্থিত প্ল্যাটফর্মের পূর্ণ তালিকার জন্য
> [অ্যাকাউন্ট সংযুক্ত করা](/bn/get-started/connecting-accounts.md) দেখুন।

```json রেসপন্স theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "text": "Hello from the API!",
  "socialMedia": "TWITTER",
  "postType": "TEXT",
  "postStatus": "SCHEDULED",
  "createdAt": "2025-01-15T09:00:00.000Z"
}
```

## পোস্ট শিডিউল করুন

ভবিষ্যতের জন্য পোস্ট শিডিউল করতে, তৈরি করার সময় `scheduledAt` যোগ করুন:

```bash theme={null}
curl -X POST https://api.so-me.studio/v1/posts \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Scheduled post!",
    "socialMedia": "LINKEDIN",
    "postType": "TEXT",
    "scheduledAt": "2025-02-01T12:00:00Z"
  }'
```

অথবা আগে থেকে থাকা কোনো পোস্ট শিডিউল করুন:

```bash theme={null}
curl -X POST https://api.so-me.studio/v1/posts/{id}/schedule \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduledAt": "2025-02-01T12:00:00Z"
  }'
```

## পোস্টের তালিকা

ঐচ্ছিক ফিল্টারসহ আপনার ওয়ার্কস্পেসের পোস্ট আনুন। `status` ফিল্টারটি রেসপন্সে ফেরত আসা
`postStatus` ফিল্ডের সঙ্গে মেলে, আর `socialMedia` প্ল্যাটফর্ম অনুযায়ী ফিল্টার করে:

```bash theme={null}
curl "https://api.so-me.studio/v1/posts?status=SCHEDULED&socialMedia=TWITTER&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"
```

## Upload media

ছবি ও ভিডিও পোস্টের জন্য প্রথমে একটি presigned আপলোড URL নিন:

```bash theme={null}
curl -X POST https://api.so-me.studio/v1/posts/presign-media \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "postType": "IMAGE",
    "socialMedia": "INSTAGRAM",
    "files": [{
      "filename": "photo.jpg",
      "mimetype": "image/jpeg",
      "size": 1024000
    }]
  }'
```

এরপর HTTP `PUT` দিয়ে আপনার ফাইল ফেরত আসা `uploadUrl`-এ আপলোড করুন। আপনার ঘোষণা করা
`mimetype`-এর সমান মানসহ একটি `Content-Type` হেডার পাঠান:

```bash theme={null}
curl -X PUT "UPLOAD_URL_FROM_THE_RESPONSE" \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo.jpg
```

> [!WARNING]
>
> আপলোড URL-টি ঘোষিত `mimetype` দিয়ে সাইন করা। `Content-Type` হেডার ছাড়া `PUT` (যেমন `curl -T` বা Python-এর
> `requests.put(url, data=f)`), অথবা ভিন্ন মানসহ `PUT` পাঠালে
> `403 SignatureDoesNotMatch` ত্রুটিতে ব্যর্থ হয়।

এরপর পোস্ট তৈরির রিকোয়েস্টে `s3Prefix` ও `fileSrc` ব্যবহার করুন।

## পরবর্তী ধাপ

> **[API রেফারেন্স](/bn/api-reference)**
>
> ইন্টারঅ্যাক্টিভ প্লেগ্রাউন্ডসহ সম্পূর্ণ এন্ডপয়েন্ট রেফারেন্স

> **[MCP সার্ভার](/bn/mcp/overview.md)**
>
> Model Context Protocol-এর মাধ্যমে AI এজেন্ট সংযুক্ত করুন


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