Kimlik Doğrulama
Sosyal Köprü API, Bearer Token kimlik doğrulama yöntemini kullanır. Her istekte Authorization başlığında geçerli bir API anahtarı gönderilmelidir.
API Anahtarı Alma
- Sosyal Köprü Paneli ’ne giriş yapın
- Ayarlar → Geliştirici API bölümüne gidin
- Yeni Anahtar Oluştur butonuna tıklayın
- Anahtara bir isim verin, kapsamları ve opsiyonel süre sonu seçin
- Oluşturulan anahtarı güvenli bir yere kaydedin
API anahtarı yalnızca oluşturulduğu anda görüntülenir. Kaybetmeniz durumunda yeni bir anahtar oluşturmanız gerekir.
İstek Başlığı
Authorization: Bearer YOUR_API_KEYAnahtarlar iki ortamda çalışır:
sk_live_...— Üretim ortamı, gerçek platform API’leri çağrılırsk_test_...— Sandbox ortamı, platform çağrısı yapılmaz, mock veriler döner
Kod Örnekleri
Node.js
const BASE_URL = 'https://api.sosyalkopru.com/v1'
const headers = {
'Authorization': `Bearer ${process.env.SOSYALKOPRU_API_KEY}`,
'Content-Type': 'application/json',
}
const response = await fetch(`${BASE_URL}/me`, { headers })
const { data } = await response.json()
console.log('Merhaba,', data.name)API Anahtarı Kapsamları
Her API anahtarı, belirli kaynaklara erişimi kısıtlamak için kapsamlarla yapılandırılabilir.
| Kapsam | Açıklama |
|---|---|
posts:read | Gönderileri listeleme ve sorgulama |
posts:write | Gönderi oluşturma, güncelleme, iptal etme |
accounts:read | Hesapları listeleme ve sorgulama |
analytics:read | Analitik verilerine erişim |
media:read | Medya dosyası bilgisi sorgulama |
media:write | Medya dosyası yükleme ve silme |
webhooks:read | Webhook listesi ve detayları |
webhooks:write | Webhook oluşturma, güncelleme ve silme |
workspaces:read | Workspace bilgisi ve üye listesi |
templates:read | Şablon listeleme ve sorgulama |
templates:write | Şablon oluşturma, güncelleme ve silme |
hashtags:read | Hashtag grubu listeleme |
hashtags:write | Hashtag grubu oluşturma, güncelleme ve silme |
queue:read | Kuyruk ve girdi listeleme |
queue:write | Kuyruk oluşturma, güncelleme ve girdi yönetimi |
usage:read | API kullanım istatistiklerine erişim |
Kapsam yetkisi olmayan bir endpoint’e erişmeye çalışırsanız API 403 kodu ve FORBIDDEN_SCOPE hata mesajı döner.
Sandbox Modu
Test anahtarları (sk_test_ önekli) sandbox modunda çalışır:
- Platform API’leri çağrılmaz — sahte yanıtlar döner
- Gerçek hesaplar ve gönderiler etkilenmez
- Kredi tüketimi gerçekleşmez
- Analytics endpoint’leri statik örnek veri döner
- Medya yükleme mock bir URL döner
Sandbox modunda olup olmadığınızı her API yanıtının meta.sandbox alanından anlayabilirsiniz.
Hız Limitleri
Sliding window algoritması ile üç pencerede uygulanır:
| Plan | Dakika | Saat | Gün |
|---|---|---|---|
| Starter | 60 | 1.000 | 5.000 |
| Growth | 300 | 10.000 | 50.000 |
| Agency Pro | 1.000 | 50.000 | Sınırsız |
Hız limitine ulaşıldığında API 429 Too Many Requests döner. Retry-After başlığı kaç saniye beklenmesi gerektiğini belirtir.
IP Kısıtlama (Opsiyonel)
Panel üzerinden API anahtarınıza izin verilen IP adresleri ekleyebilirsiniz. Listelenmemiş IP’den gelen istekler IP_NOT_WHITELISTED hatası ile reddedilir.