Skip to Content
GirişKimlik Doğrulama

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

  1. Sosyal Köprü Paneli ’ne giriş yapın
  2. Ayarlar → Geliştirici API bölümüne gidin
  3. Yeni Anahtar Oluştur butonuna tıklayın
  4. Anahtara bir isim verin, kapsamları ve opsiyonel süre sonu seçin
  5. 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_KEY

Anahtarlar iki ortamda çalışır:

  • sk_live_... — Üretim ortamı, gerçek platform API’leri çağrılır
  • sk_test_... — Sandbox ortamı, platform çağrısı yapılmaz, mock veriler döner

Kod Örnekleri

auth.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.

KapsamAçıklama
posts:readGönderileri listeleme ve sorgulama
posts:writeGönderi oluşturma, güncelleme, iptal etme
accounts:readHesapları listeleme ve sorgulama
analytics:readAnalitik verilerine erişim
media:readMedya dosyası bilgisi sorgulama
media:writeMedya dosyası yükleme ve silme
webhooks:readWebhook listesi ve detayları
webhooks:writeWebhook oluşturma, güncelleme ve silme
workspaces:readWorkspace bilgisi ve üye listesi
templates:readŞablon listeleme ve sorgulama
templates:writeŞablon oluşturma, güncelleme ve silme
hashtags:readHashtag grubu listeleme
hashtags:writeHashtag grubu oluşturma, güncelleme ve silme
queue:readKuyruk ve girdi listeleme
queue:writeKuyruk oluşturma, güncelleme ve girdi yönetimi
usage:readAPI 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:

PlanDakikaSaatGün
Starter601.0005.000
Growth30010.00050.000
Agency Pro1.00050.000Sı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.

Last updated on