Postlar

Sosyal medya gönderilerinizi oluşturun, planlayın, taslak olarak saklayın ve tüm platformlarda yayınlayın. Platform bazlı içerik özelleştirmesi, toplu işlemler ve anlık yayın desteği sunar.

Gönderi Oluştur / Planla

POST/v1/posts

Yeni bir gönderi oluşturur. scheduling.publishAt verilirse belirlenen zamanda yayınlanır. Verilmezse isDraft: true ile taslak, isDraft: false ile anlık yayın başlar.

İstek Gövdesi

Alan	Tip	Zorunlu	Varsayılan	Açıklama
`platforms`	`string[]`	Evet	—	Platform listesi: `instagram` `facebook` `linkedin` `tiktok` `twitter` `youtube`
`accountIds`	`string[]`	Evet	—	Gönderi yapılacak hesap ID’leri
`content.text`	`string`	Evet	—	Gönderi metni (maks. 63.206 karakter)
`content.media`	`object[]`	Hayır	—	Medya eklentileri
`content.media[].mediaId`	`string`	Evet*	—	`/media/upload` ile alınan medya ID’si
`content.media[].order`	`integer`	Hayır	`0`	Gösterim sırası
`content.platformOverrides`	`object`	Hayır	—	Platform bazlı içerik özelleştirmeleri (bkz. aşağı)
`scheduling.publishAt`	`string`	Hayır	—	Yayın zamanı — ISO 8601
`scheduling.timezone`	`string`	Hayır	`Europe/Istanbul`	Zaman dilimi
`title`	`string`	Hayır	—	İç başlık (maks. 255 karakter, dashboardda görünür)
`tags`	`string[]`	Hayır	`[]`	İç etiketler (filtreleme için)
`isDraft`	`boolean`	Hayır	`false`	`true` ise taslak olarak kaydeder, yayınlamaz

Platform Özelleştirmeleri (`content.platformOverrides`)

Her platform için farklı metin veya medya seti belirtebilirsiniz:


"platformOverrides": {
  "instagram": {
    "text": "Instagram'a özel metin #instagram",
    "media": [{ "mediaId": "media_01XYZ", "order": 0 }]
  },
  "linkedin": {
    "text": "LinkedIn için daha profesyonel bir metin."
  }
}

Kod Örnekleri

Node.js

post-olustur.js


const response = await fetch('https://api.sosyalkopru.com/v1/posts', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    platforms: ['instagram', 'linkedin'],
    accountIds: ['acc_01HZGK9P3QXYZ'],
    title: 'Ürün Lansmanı - Haziran 2025',
    tags: ['lansman', 'instagram'],
    content: {
      text: 'Yeni ürünümüzü tanıtmaktan mutluluk duyuyoruz! 🚀 #sosyalkopru',
      platformOverrides: {
        linkedin: {
          text: 'Yeni ürünümüzü resmi olarak tanıtmaktan büyük memnuniyet duyuyoruz.',
        },
      },
    },
    scheduling: {
      publishAt: '2025-06-15T10:00:00Z',
      timezone: 'Europe/Istanbul',
    },
  }),
})
 
const { data } = await response.json()
console.log('Gönderi planlandı:', data.id, '|', data.status)

Python

post_olustur.py


import os
import requests
 
response = requests.post(
    "https://api.sosyalkopru.com/v1/posts",
    headers={
        "Authorization": f"Bearer {os.environ['SOSYALKOPRU_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "platforms": ["instagram", "linkedin"],
        "accountIds": ["acc_01HZGK9P3QXYZ"],
        "title": "Ürün Lansmanı - Haziran 2025",
        "tags": ["lansman"],
        "content": {
            "text": "Yeni ürünümüzü tanıtmaktan mutluluk duyuyoruz! 🚀 #sosyalkopru",
            "platformOverrides": {
                "linkedin": {
                    "text": "Yeni ürünümüzü resmi olarak tanıtmaktan büyük memnuniyet duyuyoruz."
                }
            },
        },
        "scheduling": {
            "publishAt": "2025-06-15T10:00:00Z",
            "timezone": "Europe/Istanbul",
        },
    },
)
response.raise_for_status()
data = response.json()["data"]
print(f"Gönderi planlandı: {data['id']} | {data['status']}")

PHP

post_olustur.php


<?php
require 'vendor/autoload.php';
 
use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;
 
$client = new Client();
 
try {
    $response = $client->post('https://api.sosyalkopru.com/v1/posts', [
        'headers' => [
            'Authorization' => 'Bearer ' . getenv('SOSYALKOPRU_API_KEY'),
            'Content-Type' => 'application/json',
        ],
        'json' => [
            'platforms' => ['instagram', 'linkedin'],
            'accountIds' => ['acc_01HZGK9P3QXYZ'],
            'title' => 'Ürün Lansmanı - Haziran 2025',
            'tags' => ['lansman', 'instagram'],
            'content' => [
                'text' => 'Yeni ürünümüzü tanıtmaktan mutluluk duyuyoruz! 🚀 #sosyalkopru',
                'platformOverrides' => [
                    'linkedin' => [
                        'text' => 'Yeni ürünümüzü resmi olarak tanıtmaktan büyük memnuniyet duyuyoruz.',
                    ],
                ],
            ],
            'scheduling' => [
                'publishAt' => '2025-06-15T10:00:00Z',
                'timezone' => 'Europe/Istanbul',
            ],
        ],
    ]);
 
    $data = json_decode($response->getBody(), true)['data'];
    echo "Gönderi planlandı: {$data['id']} | {$data['status']}\n";
} catch (RequestException $e) {
    echo "Hata: " . $e->getMessage() . "\n";
}

Go

post_olustur.go


package main
 
import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"os"
)
 
func main() {
	apiKey := os.Getenv("SOSYALKOPRU_API_KEY")
	url := "https://api.sosyalkopru.com/v1/posts"
 
	body := map[string]interface{}{
		"platforms":  []string{"instagram", "linkedin"},
		"accountIds": []string{"acc_01HZGK9P3QXYZ"},
		"title":      "Ürün Lansmanı - Haziran 2025",
		"tags":       []string{"lansman"},
		"content": map[string]interface{}{
			"text": "Yeni ürünümüzü tanıtmaktan mutluluk duyuyoruz! 🚀 #sosyalkopru",
			"platformOverrides": map[string]interface{}{
				"linkedin": map[string]string{
					"text": "Yeni ürünümüzü resmi olarak tanıtmaktan büyük memnuniyet duyuyoruz.",
				},
			},
		},
		"scheduling": map[string]string{
			"publishAt": "2025-06-15T10:00:00Z",
			"timezone":  "Europe/Istanbul",
		},
	}
 
	jsonBody, _ := json.Marshal(body)
 
	req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonBody))
	req.Header.Set("Authorization", "Bearer "+apiKey)
	req.Header.Set("Content-Type", "application/json")
 
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
 
	bodyBytes, _ := io.ReadAll(resp.Body)
	var result map[string]interface{}
	json.Unmarshal(bodyBytes, &result)
 
	data := result["data"].(map[string]interface{})
	fmt.Printf("Gönderi planlandı: %s | %s\n", data["id"], data["status"])
}

Java

PostOlustur.java


import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.nio.charset.StandardCharsets;
 
public class PostOlustur {
    public static void main(String[] args) throws Exception {
        String apiKey = System.getenv("SOSYALKOPRU_API_KEY");
        String url = "https://api.sosyalkopru.com/v1/posts";
 
        String json = """
            {
              "platforms": ["instagram", "linkedin"],
              "accountIds": ["acc_01HZGK9P3QXYZ"],
              "title": "Ürün Lansmanı - Haziran 2025",
              "tags": ["lansman"],
              "content": {
                "text": "Yeni ürünümüzü tanıtmaktan mutluluk duyuyoruz! 🚀 #sosyalkopru",
                "platformOverrides": {
                  "linkedin": { "text": "Yeni ürünümüzü resmi olarak tanıtmaktan büyük memnuniyet duyuyoruz." }
                }
              },
              "scheduling": {
                "publishAt": "2025-06-15T10:00:00Z",
                "timezone": "Europe/Istanbul"
              }
            }
            """;
 
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Authorization", "Bearer " + apiKey)
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(json, StandardCharsets.UTF_8))
            .build();
 
        HttpResponse<String> response = client.send(request, BodyHandlers.ofString());
        System.out.println("Response: " + response.body());
        // JSON parse için Jackson veya Gson kullanabilirsiniz
    }
}

cURL

post-olustur.sh


curl -X POST https://api.sosyalkopru.com/v1/posts \
  -H "Authorization: Bearer $SOSYALKOPRU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["instagram", "linkedin"],
    "accountIds": ["acc_01HZGK9P3QXYZ"],
    "content": { "text": "Yeni ürünümüzü tanıtmaktan mutluluk duyuyoruz! 🚀" },
    "scheduling": { "publishAt": "2025-06-15T10:00:00Z" }
  }'

Başarılı Yanıtlar

Planlı gönderi (201 Created):


{
  "success": true,
  "data": {
    "id": "post_01HZGK9P3QABC",
    "status": "SCHEDULED",
    "title": "Ürün Lansmanı - Haziran 2025",
    "tags": ["lansman"],
    "scheduledAt": "2025-06-15T07:00:00.000Z",
    "createdAt": "2025-06-10T12:00:00.000Z"
  },
  "meta": { "requestId": "req_01XYZ", "timestamp": "...", "version": "1" }
}

Anlık yayın — publishing durumunda BullMQ kuyruğuna eklenir (201 Created):


{
  "success": true,
  "data": {
    "id": "post_01HZGK9P3QABC",
    "status": "publishing",
    "message": "Gönderi yayın kuyruğuna eklendi.",
    "createdAt": "2025-06-10T12:00:00.000Z"
  },
  "meta": { "requestId": "req_01XYZ", "timestamp": "...", "version": "1" }
}

Taslak (isDraft: true, 201 Created):


{
  "success": true,
  "data": {
    "id": "post_01HZGK9P3QABC",
    "status": "DRAFT",
    "createdAt": "2025-06-10T12:00:00.000Z"
  },
  "meta": { "requestId": "req_01XYZ", "timestamp": "...", "version": "1" }
}

Anlık yayın isteklerinde gönderi hemen PUBLISHED dönmez — yayın işlemi asenkron olarak BullMQ worker tarafından işlenir. Durumu takip etmek için GET /posts/{id}/status endpoint’ini polling ile kullanın.

Gönderileri Listele

GET/v1/posts

Kullanıcının gönderilerini sayfalandırılmış olarak döner.

Query Parametreleri

Parametre	Tip	Varsayılan	Açıklama
`page`	`integer`	`1`	Sayfa numarası
`perPage`	`integer`	`20`	Sayfa başına kayıt (maks: 100)
`status`	`string`	—	`draft` `scheduled` `publishing` `published` `failed` `cancelled`
`platform`	`string`	—	Platform filtresi
`workspaceId`	`string`	—	Workspace filtresi
`startDate`	`string`	—	ISO 8601 başlangıç
`endDate`	`string`	—	ISO 8601 bitiş
`tag`	`string`	—	İç etiket filtresi

Kod Örnekleri

Node.js

post-listele.js


const params = new URLSearchParams({
  page: '1',
  perPage: '20',
  status: 'scheduled',
})
 
const response = await fetch(
  `https://api.sosyalkopru.com/v1/posts?${params}`,
  { headers: { 'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}` } }
)
const { data, pagination } = await response.json()
console.log(`${pagination.total} gönderi — ${pagination.totalPages} sayfa`)
data.forEach(p => console.log(p.id, p.status, p.scheduledAt ?? ''))

Python

post_listele.py


response = requests.get(
    "https://api.sosyalkopru.com/v1/posts",
    headers={"Authorization": f"Bearer {os.environ['SOSYALKOPRU_API_KEY']}"},
    params={"page": 1, "perPage": 20, "status": "scheduled"},
)
response.raise_for_status()
body = response.json()
p = body["pagination"]
print(f"{p['total']} gönderi — {p['totalPages']} sayfa")
for post in body["data"]:
    print(post["id"], post["status"])

PHP

post_listele.php


<?php
$apiKey = getenv('SOSYALKOPRU_API_KEY');
$params = http_build_query([
    'page' => 1,
    'perPage' => 20,
    'status' => 'scheduled',
]);
 
$ch = curl_init("https://api.sosyalkopru.com/v1/posts?{$params}");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer {$apiKey}"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);
$p = $data['pagination'];
echo "{$p['total']} gönderi — {$p['totalPages']} sayfa\n";
foreach ($data['data'] as $post) {
    echo $post['id'] . ' ' . $post['status'] . "\n";
}

Go

post_listele.go


package main
 
import (
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"net/url"
	"os"
)
 
func main() {
	apiKey := os.Getenv("SOSYALKOPRU_API_KEY")
	baseURL := "https://api.sosyalkopru.com/v1/posts"
 
	params := url.Values{}
	params.Set("page", "1")
	params.Set("perPage", "20")
	params.Set("status", "scheduled")
 
	req, _ := http.NewRequest("GET", baseURL+"?"+params.Encode(), nil)
	req.Header.Set("Authorization", "Bearer "+apiKey)
 
	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
 
	bodyBytes, _ := io.ReadAll(resp.Body)
	var result map[string]interface{}
	json.Unmarshal(bodyBytes, &result)
 
	body := result["data"].([]interface{})
	p := result["pagination"].(map[string]interface{})
	fmt.Printf("%v gönderi — %v sayfa\n", p["total"], p["totalPages"])
 
	for _, post := range body {
		p := post.(map[string]interface{})
		fmt.Println(p["id"], p["status"])
	}
}

Java

PostListele.java


import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
 
public class PostListele {
    public static void main(String[] args) throws Exception {
        String apiKey = System.getenv("SOSYALKOPRU_API_KEY");
        String base = "https://api.sosyalkopru.com/v1/posts";
        String params = "page=1&perPage=20&status=scheduled";
 
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(base + "?" + params))
            .header("Authorization", "Bearer " + apiKey)
            .GET()
            .build();
 
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
        // JSON parse ve pagination için kütüphane kullanın (Jackson vb.)
    }
}

cURL

post-listele.sh


curl "https://api.sosyalkopru.com/v1/posts?status=scheduled&perPage=20" \
  -H "Authorization: Bearer $SOSYALKOPRU_API_KEY"

Başarılı Yanıt


{
  "success": true,
  "data": [
    {
      "id": "post_01HZGK9P3QABC",
      "title": "Ürün Lansmanı",
      "tags": ["lansman"],
      "content": { "text": "Gönderi metni..." },
      "status": "SCHEDULED",
      "scheduledAt": "2025-06-15T07:00:00.000Z",
      "publishedAt": null,
      "platforms": ["instagram", "linkedin"],
      "createdAt": "2025-06-10T12:00:00.000Z"
    }
  ],
  "meta": { "requestId": "req_01XYZ", "timestamp": "...", "version": "1" },
  "pagination": {
    "page": 1,
    "perPage": 20,
    "total": 47,
    "totalPages": 3,
    "hasNextPage": true,
    "hasPrevPage": false
  }
}

Gönderi Detayı

GET/v1/posts/{id}

Tek bir gönderinin tüm detaylarını, platform bazlı durumları ve metrikleriyle döner.

Path Parametresi

Parametre	Açıklama
`id`	Gönderi ID’si (`post_...`)

Kod Örnekleri

Node.js

post-detay.js


const response = await fetch(
  `https://api.sosyalkopru.com/v1/posts/${postId}`,
  { headers: { 'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}` } }
)
const { data } = await response.json()
console.log('Durum:', data.status)
data.platforms.forEach(p => {
  console.log(`  [${p.platform}] ${p.status}`)
  if (p.metrics) {
    console.log(`    Beğeni: ${p.metrics.likes} | Yorum: ${p.metrics.comments}`)
  }
})

Python

post_detay.py


response = requests.get(
    f"https://api.sosyalkopru.com/v1/posts/{post_id}",
    headers={"Authorization": f"Bearer {os.environ['SOSYALKOPRU_API_KEY']}"},
)
response.raise_for_status()
data = response.json()["data"]
print(f"Durum: {data['status']}")
for p in data["platforms"]:
    print(f"  [{p['platform']}] {p['status']}")
    if p.get("metrics"):
        print(f"    Beğeni: {p['metrics']['likes']}")

PHP

post-detay.sh


curl https://api.sosyalkopru.com/v1/posts/post_01HZGK9P3QABC \
  -H "Authorization: Bearer $SOSYALKOPRU_API_KEY"

Başarılı Yanıt


{
  "success": true,
  "data": {
    "id": "post_01HZGK9P3QABC",
    "title": "Ürün Lansmanı",
    "tags": ["lansman"],
    "content": {
      "text": "Gönderi metni...",
      "media": []
    },
    "status": "PUBLISHED",
    "scheduledAt": null,
    "publishedAt": "2025-06-10T12:00:00.000Z",
    "platforms": [
      {
        "platform": "instagram",
        "username": "@sosyalkopru",
        "status": "PUBLISHED",
        "platformPostId": "17862...",
        "platformPostUrl": "https://instagram.com/p/ABC123",
        "errorMessage": null,
        "metrics": {
          "likes": 142,
          "comments": 18,
          "shares": 5,
          "reach": 2300,
          "impressions": 3100
        }
      }
    ],
    "createdAt": "2025-06-10T11:55:00.000Z",
    "updatedAt": "2025-06-10T12:00:05.000Z"
  },
  "meta": { "requestId": "req_01XYZ", "timestamp": "...", "version": "1" }
}

Gönderi Güncelle

PATCH/v1/posts/{id}

Yalnızca SCHEDULED veya DRAFT statüsündeki gönderileri güncelleyebilirsiniz.

İstek Gövdesi

Alan	Tip	Açıklama
`content.text`	`string`	Yeni gönderi metni
`content.platformOverrides`	`object`	Platform bazlı özelleştirmeler
`scheduling.publishAt`	`string`	Yeni yayın zamanı (ISO 8601)
`title`	`string`	Yeni iç başlık
`tags`	`string[]`	Yeni etiket listesi
`isDraft`	`boolean`	`false` ile taslağı yayına alabilirsiniz

Kod Örnekleri

Node.js

post-guncelle.js


const response = await fetch(
  `https://api.sosyalkopru.com/v1/posts/${postId}`,
  {
    method: 'PATCH',
    headers: {
      'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      content: { text: 'Güncellenmiş gönderi metni #sosyalkopru' },
      scheduling: { publishAt: '2025-06-16T10:00:00Z' },
      tags: ['lansman', 'guncellendi'],
    }),
  }
)
const { data } = await response.json()
console.log('Güncellendi:', data.scheduledAt)

Python

post_guncelle.py


response = requests.patch(
    f"https://api.sosyalkopru.com/v1/posts/{post_id}",
    headers={
        "Authorization": f"Bearer {os.environ['SOSYALKOPRU_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "content": {"text": "Güncellenmiş gönderi metni #sosyalkopru"},
        "scheduling": {"publishAt": "2025-06-16T10:00:00Z"},
    },
)
response.raise_for_status()
print("Güncellendi:", response.json()["data"]["scheduledAt"])

PHP

post-guncelle.sh


curl -X PATCH https://api.sosyalkopru.com/v1/posts/post_01HZGK9P3QABC \
  -H "Authorization: Bearer $SOSYALKOPRU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": {"text": "Güncellenmiş metin"}, "scheduling": {"publishAt": "2025-06-16T10:00:00Z"}}'

PUBLISHED, PUBLISHING veya FAILED durumundaki gönderiler güncellenemez — 422 Unprocessable Entity hatası döner.

Gönderi İptal Et / Sil

DELETE/v1/posts/{id}

Planlanmış veya taslak bir gönderiyi iptal eder. PUBLISHED veya PUBLISHING durumundaki gönderiler silinemez.

Kod Örnekleri

Node.js

post-iptal.js


const response = await fetch(
  `https://api.sosyalkopru.com/v1/posts/${postId}`,
  {
    method: 'DELETE',
    headers: { 'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}` },
  }
)
const { data } = await response.json()
console.log('İptal edildi:', data.id)

Python

post_iptal.py


response = requests.delete(
    f"https://api.sosyalkopru.com/v1/posts/{post_id}",
    headers={"Authorization": f"Bearer {os.environ['SOSYALKOPRU_API_KEY']}"},
)
response.raise_for_status()
print("İptal edildi:", response.json()["data"]["id"])

PHP

post-iptal.sh


curl -X DELETE https://api.sosyalkopru.com/v1/posts/post_01HZGK9P3QABC \
  -H "Authorization: Bearer $SOSYALKOPRU_API_KEY"

Yayın Durumu

GET/v1/posts/{id}/status

Bir gönderinin platform bazlı anlık yayın durumunu ve BullMQ iş bilgisini döner.

Kod Örnekleri

Node.js

post-durum.js


const poll = async (postId) => {
  while (true) {
    const response = await fetch(
      `https://api.sosyalkopru.com/v1/posts/${postId}/status`,
      { headers: { 'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}` } }
    )
    const { data } = await response.json()
 
    if (['PUBLISHED', 'PARTIAL', 'FAILED'].includes(data.overallStatus)) {
      console.log('Tamamlandı:', data.overallStatus)
      return data
    }
 
    console.log('Bekleniyor:', data.overallStatus, '— 3 saniye sonra tekrar...')
    await new Promise(r => setTimeout(r, 3000))
  }
}
 
await poll('post_01HZGK9P3QABC')

Python

post_durum.py


import time
 
def poll_status(post_id, interval=3):
    terminal = {"PUBLISHED", "PARTIAL", "FAILED", "CANCELLED"}
    while True:
        response = requests.get(
            f"https://api.sosyalkopru.com/v1/posts/{post_id}/status",
            headers={"Authorization": f"Bearer {os.environ['SOSYALKOPRU_API_KEY']}"},
        )
        response.raise_for_status()
        data = response.json()["data"]
        if data["overallStatus"] in terminal:
            print(f"Tamamlandı: {data['overallStatus']}")
            return data
        print(f"Bekleniyor: {data['overallStatus']}")
        time.sleep(interval)
 
poll_status("post_01HZGK9P3QABC")

PHP

post-durum.sh


curl https://api.sosyalkopru.com/v1/posts/post_01HZGK9P3QABC/status \
  -H "Authorization: Bearer $SOSYALKOPRU_API_KEY"

Başarılı Yanıt


{
  "success": true,
  "data": {
    "postId": "post_01HZGK9P3QABC",
    "overallStatus": "PARTIAL",
    "job": {
      "id": "job_01XYZ",
      "state": "completed",
      "progress": 100,
      "attemptsMade": 1
    },
    "platforms": [
      {
        "platform": "instagram",
        "username": "@sosyalkopru",
        "status": "PUBLISHED",
        "publishedAt": "2025-06-10T12:00:05.000Z",
        "platformPostId": "17862...",
        "platformPostUrl": "https://instagram.com/p/ABC123",
        "errorMessage": null
      },
      {
        "platform": "facebook",
        "username": "Sosyal Köprü",
        "status": "FAILED",
        "publishedAt": null,
        "platformPostId": null,
        "platformPostUrl": null,
        "errorMessage": "Oturum süresi doldu, hesabı yeniden bağlayın"
      }
    ]
  },
  "meta": { "requestId": "req_01XYZ", "timestamp": "...", "version": "1" }
}

Gönderi Kopyala

POST/v1/posts/{id}/duplicate

Bir gönderiyi taslak olarak kopyalar. Tüm içerik, medya ve platform ayarları kopyalanır; scheduledAt temizlenir.

Kod Örnekleri

Node.js

post-kopyala.js


const response = await fetch(
  `https://api.sosyalkopru.com/v1/posts/${postId}/duplicate`,
  {
    method: 'POST',
    headers: { 'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}` },
  }
)
const { data } = await response.json()
console.log('Kopyalandı. Yeni taslak ID:', data.id)

Python

post_kopyala.py


response = requests.post(
    f"https://api.sosyalkopru.com/v1/posts/{post_id}/duplicate",
    headers={"Authorization": f"Bearer {os.environ['SOSYALKOPRU_API_KEY']}"},
)
response.raise_for_status()
print("Yeni taslak:", response.json()["data"]["id"])

PHP

post-kopyala.sh


curl -X POST https://api.sosyalkopru.com/v1/posts/post_01HZGK9P3QABC/duplicate \
  -H "Authorization: Bearer $SOSYALKOPRU_API_KEY"

Başarılı Yanıt


{
  "success": true,
  "data": {
    "id": "post_01HZGK9P3QNEW",
    "status": "DRAFT",
    "originalPostId": "post_01HZGK9P3QABC",
    "createdAt": "2025-06-10T13:00:00.000Z"
  },
  "meta": { "requestId": "req_01XYZ", "timestamp": "...", "version": "1" }
}

Toplu İşlemler

POST/v1/posts/bulk

Birden fazla gönderi üzerinde aynı anda delete, cancel veya reschedule işlemi yapar. Tek seferde en fazla 50 gönderi işlenebilir.

İstek Gövdesi

Alan	Tip	Zorunlu	Açıklama
`action`	`string`	Evet	`delete` `cancel` `reschedule`
`postIds`	`string[]`	Evet	İşlenecek gönderi ID’leri (maks. 50)
`publishAt`	`string`	`reschedule` için	Yeni yayın zamanı (ISO 8601)

Kod Örnekleri

Node.js

post-bulk.js


// Toplu iptal
const cancelResponse = await fetch('https://api.sosyalkopru.com/v1/posts/bulk', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    action: 'cancel',
    postIds: [
      'post_01HZGK9P3QABC',
      'post_01HZGK9P3QDEF',
      'post_01HZGK9P3QGHI',
    ],
  }),
})
const { data } = await cancelResponse.json()
console.log(`Başarılı: ${data.succeeded} | Başarısız: ${data.failed}`)
 
// Toplu yeniden planlama
const rescheduleResponse = await fetch('https://api.sosyalkopru.com/v1/posts/bulk', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    action: 'reschedule',
    postIds: ['post_01HZGK9P3QABC', 'post_01HZGK9P3QDEF'],
    publishAt: '2025-06-20T09:00:00Z',
  }),
})

Python

post_bulk.py


response = requests.post(
    "https://api.sosyalkopru.com/v1/posts/bulk",
    headers={
        "Authorization": f"Bearer {os.environ['SOSYALKOPRU_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "action": "cancel",
        "postIds": [
            "post_01HZGK9P3QABC",
            "post_01HZGK9P3QDEF",
        ],
    },
)
response.raise_for_status()
data = response.json()["data"]
print(f"Başarılı: {data['succeeded']} | Başarısız: {data['failed']}")
for err in data.get("errors", []):
    print(f"  {err['id']}: {err['reason']}")

PHP

post-bulk.sh


curl -X POST https://api.sosyalkopru.com/v1/posts/bulk \
  -H "Authorization: Bearer $SOSYALKOPRU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "cancel",
    "postIds": ["post_01HZGK9P3QABC", "post_01HZGK9P3QDEF"]
  }'

Başarılı Yanıt


{
  "success": true,
  "data": {
    "action": "cancel",
    "processed": 3,
    "succeeded": 2,
    "failed": 1,
    "errors": [
      {
        "id": "post_01HZGK9P3QGHI",
        "reason": "PUBLISHED gönderiler iptal edilemez"
      }
    ]
  },
  "meta": { "requestId": "req_01XYZ", "timestamp": "...", "version": "1" }
}

Gönderi Statüleri

Statü	Açıklama
`DRAFT`	Taslak — henüz planlanmamış
`SCHEDULED`	Gelecek bir zamana planlandı
`PUBLISHING`	BullMQ kuyruğunda işleniyor
`PUBLISHED`	Tüm platformlarda başarıyla yayınlandı
`PARTIAL`	Bazı platformlarda başarılı, bazılarında başarısız
`FAILED`	Tüm platformlarda başarısız
`CANCELLED`	İptal edildi

Desteklenen Platformlar

Değer	Platform
`instagram`	Instagram
`facebook`	Facebook
`linkedin`	LinkedIn
`tiktok`	TikTok
`twitter`	Twitter / X
`youtube`	YouTube

Postlar

Gönderi Oluştur / Planla

İstek Gövdesi

Platform Özelleştirmeleri (content.platformOverrides)

Kod Örnekleri

Node.js

Python

PHP

Go

Java

cURL

Başarılı Yanıtlar

Gönderileri Listele

Query Parametreleri

Kod Örnekleri

Node.js

Python

PHP

Go

Java

cURL

Başarılı Yanıt

Gönderi Detayı

Path Parametresi

Kod Örnekleri

Node.js

Python

PHP

Başarılı Yanıt

Gönderi Güncelle

İstek Gövdesi

Kod Örnekleri

Node.js

Python

PHP

Gönderi İptal Et / Sil

Kod Örnekleri

Node.js

Python

PHP

Yayın Durumu

Kod Örnekleri

Node.js

Python

PHP

Başarılı Yanıt

Gönderi Kopyala

Kod Örnekleri

Node.js

Python

PHP

Başarılı Yanıt

Toplu İşlemler

İstek Gövdesi

Kod Örnekleri

Node.js

Python

PHP

Başarılı Yanıt

Gönderi Statüleri

Desteklenen Platformlar

Platform Özelleştirmeleri (`content.platformOverrides`)