Hızlı Başlangıç

Bu rehber, Sosyal Köprü API’sini kullanmaya başlamanız için gereken adımları içerir. Yaklaşık 10 dakikada ilk gönderinizi API aracılığıyla yayınlayabilirsiniz.

Ön Koşul: Sosyal Köprü hesabınız ve en az bir bağlı sosyal medya hesabınız olmalıdır.

API Anahtarı Oluşturun

Sosyal Köprü Paneli ’ne gidin ve yeni bir API anahtarı oluşturun.

Test için sk_test_ önekli bir sandbox anahtarı kullanın. Üretim geçişinde sk_live_ önekli anahtara geçin.

Anahtarı ortam değişkeni olarak ayarlayın:


export SOSYALKOPRU_API_KEY="sk_test_..."

Kimlik Doğrulamayı Test Edin

API anahtarınızın çalıştığını /me endpoint’i ile doğrulayın:

Node.js


const response = await fetch('https://api.sosyalkopru.com/v1/me', {
  headers: { 'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}` },
})
const { data } = await response.json()
console.log('Hoş geldiniz!', data.name, '|', data.planTier)

Python


import os, requests
response = requests.get(
    "https://api.sosyalkopru.com/v1/me",
    headers={"Authorization": f"Bearer {os.environ['SOSYALKOPRU_API_KEY']}"},
)
data = response.json()["data"]
print(f"Hoş geldiniz! {data['name']} | {data['planTier']}")

PHP


<?php
$response = $client->get('me');
$data = json_decode($response->getBody(), true)['data'];
echo "Hoş geldiniz! {$data['name']} | {$data['planTier']}\n";

Go


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

Hesaplarınızı Listeleyin

Gönderi yapılabilecek sosyal medya hesabı ID’lerini alın:

Node.js


const response = await fetch('https://api.sosyalkopru.com/v1/accounts', {
  headers: { 'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}` },
})
const { data } = await response.json()
 
console.log('Bağlı hesaplar:')
data.forEach(h => console.log(`  ${h.id}  [${h.platform}] @${h.username}`))

Python


response = requests.get(
    "https://api.sosyalkopru.com/v1/accounts",
    headers={"Authorization": f"Bearer {os.environ['SOSYALKOPRU_API_KEY']}"},
)
for h in response.json()["data"]:
    print(f"  {h['id']}  [{h['platform']}] @{h['username']}")

PHP


<?php
$response = $client->get('accounts');
foreach (json_decode($response->getBody(), true)['data'] as $h) {
    echo "  {$h['id']}  [{$h['platform']}] @{$h['username']}\n";
}

Çıktıdan acc_... formatındaki hesap ID’lerini not alın.

Görsel Yükleyin (Opsiyonel)

Görsel eklenmiş bir gönderi için önce medyayı yükleyin:

Node.js


const form = new FormData()
form.append('file', new Blob([require('fs').readFileSync('./gorsel.jpg')]), 'gorsel.jpg')
 
const response = await fetch('https://api.sosyalkopru.com/v1/media/upload', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}` },
  body: form,
})
const { data: medya } = await response.json()
console.log('Media ID:', medya.mediaId)

Python


with open("gorsel.jpg", "rb") as f:
    response = requests.post(
        "https://api.sosyalkopru.com/v1/media/upload",
        headers={"Authorization": f"Bearer {os.environ['SOSYALKOPRU_API_KEY']}"},
        files={"file": f},
    )
medya = response.json()["data"]
print(f"Media ID: {medya['mediaId']}")

PHP


<?php
$response = $client->post('media/upload', [
    'multipart' => [[
        'name'     => 'file',
        'contents' => fopen('./gorsel.jpg', 'r'),
        'filename' => 'gorsel.jpg',
    ]],
]);
$medya = json_decode($response->getBody(), true)['data'];
echo "Media ID: {$medya['mediaId']}\n";

İlk Gönderinizi Oluşturun

Önceki adımlardan aldığınız accountId ve opsiyonel mediaId ile ilk gönderinizi oluşturun:

Node.js

ilk-gonderi.js


const accountId = 'acc_...' // 3. adımdan
const mediaId   = 'media_...' // 4. adımdan (opsiyonel)
 
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'],
    content: {
      text: 'Sosyal Köprü API ile ilk gönderim! 🎉 #sosyalkopru',
      ...(mediaId ? { media: [{ mediaId, order: 0 }] } : {}),
    },
    scheduling: {
      publishAt: new Date(Date.now() + 5 * 60 * 1000).toISOString(), // 5 dakika sonra
    },
    accountIds: [accountId],
  }),
})
 
const { data } = await response.json()
console.log('Gönderi oluşturuldu!')
console.log('ID    :', data.id)
console.log('Durum :', data.status)
console.log('Zaman :', data.scheduledAt)

Python

ilk_gonderi.py


from datetime import datetime, timezone, timedelta
 
account_id = "acc_..."   # 3. adımdan
media_id   = "media_..." # 4. adımdan (opsiyonel)
 
yayin_zamani = (datetime.now(timezone.utc) + timedelta(minutes=5)).isoformat()
 
body = {
    "platforms": ["instagram"],
    "content": {
        "text": "Sosyal Köprü API ile ilk gönderim! 🎉 #sosyalkopru",
    },
    "scheduling": {"publishAt": yayin_zamani},
    "accountIds": [account_id],
}
if media_id:
    body["content"]["media"] = [{"mediaId": media_id, "order": 0}]
 
response = requests.post(
    "https://api.sosyalkopru.com/v1/posts",
    headers={
        "Authorization": f"Bearer {os.environ['SOSYALKOPRU_API_KEY']}",
        "Content-Type": "application/json",
    },
    json=body,
)
response.raise_for_status()
data = response.json()["data"]
print(f"Gönderi oluşturuldu! ID: {data['id']}, Durum: {data['status']}")

PHP

ilk_gonderi.php


<?php
$accountId = 'acc_...';  // 3. adımdan
$mediaId   = 'media_...'; // 4. adımdan (opsiyonel)
 
$yayinZamani = (new DateTime('+5 minutes', new DateTimeZone('UTC')))
    ->format('Y-m-d\TH:i:s\Z');
 
$body = [
    'platforms'  => ['instagram'],
    'content'    => [
        'text' => 'Sosyal Köprü API ile ilk gönderim! 🎉 #sosyalkopru',
    ],
    'scheduling' => ['publishAt' => $yayinZamani],
    'accountIds' => [$accountId],
];
if ($mediaId) {
    $body['content']['media'] = [['mediaId' => $mediaId, 'order' => 0]];
}
 
$response = $client->post('posts', ['json' => $body]);
$data = json_decode($response->getBody(), true)['data'];
echo "Gönderi oluşturuldu! ID: {$data['id']}, Durum: {$data['status']}\n";

Yayın Durumunu Takip Edin


const statusResponse = await fetch(
  `https://api.sosyalkopru.com/v1/posts/${data.id}/status`,
  { headers: { 'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}` } }
)
const { data: status } = await statusResponse.json()
console.log('Genel durum:', status.overallStatus)

Sonraki Adımlar

Webhook Entegrasyonu — Yayın sonrası gerçek zamanlı bildirim alın
API Referansı: Postlar — Taslak, planlama, toplu işlemler ve kopyalama
Şablonlar — Yeniden kullanılabilir gönderi şablonları
Hashtagler — Hashtag gruplarını yönetin
Kuyruk — Tekrar eden yayın programları oluşturun
Kullanım — Kredi dengesi ve istek istatistikleri
Hata Kodları — Hata yönetimi stratejileri