API Changelog
A running log of additions, changes, and removals to the Sosyal Köprü API.
15 Haziran 2026
Yeni dokümantasyon bölümü: API Tercihleri — Sandbox Modu, Kapsam Yönetimi, Rate Limiting, Kredi Sistemi ve IP Whitelist sayfaları yayına alındı.
Sandbox Modu dokümantasyonu: sk_test_ prefix’li anahtarların davranışı, kredi maliyeti (%10), rate limit kapasitesi ve X-Sandbox: true başlığı detaylı olarak belgelendi.
Kapsam Yönetimi dokümantasyonu: Tüm endpoint’ler için gerekli scope matrisi (posts:read, posts:write, analytics:read, webhooks:manage, workspaces:read) yayınlandı.
Rate Limiting dokümantasyonu: Plan bazlı limitler (STARTER / GROWTH / AGENCY_PRO), yanıt başlıkları, 429 yönetimi ve exponential back-off örneği eklendi.
Kredi Sistemi dokümantasyonu: Endpoint başına maliyetler, sandbox indirimi, 402 INSUFFICIENT_CREDITS hatası ve optimizasyon ipuçları belgelendi.
IP Whitelist dokümantasyonu: IPv4/IPv6/CIDR desteği, brute-force koruması (10 hatalı deneme → 15 dk blok) ve Cloudflare entegrasyon notu eklendi.
Docs sitesinin sidebar tasarımı yenilendi: Accordion grup yapısı kaldırıldı, bölümler her zaman açık düz liste görünümüne geçildi.
Renk sistemi güncellendi: Nextra’nın hesapladığı neon/açık teal tonlar, uygulamanın ana renk paleti (#037a68) ile tam uyumlu hale getirildi. Light modda siyah, dark modda beyaz sidebar metin renkleri uygulandı.
Navbar’daki “API Anahtarı Al” butonu, web uygulamasının Neobrutalist tasarımıyla (kare border, offset gölge) uyumlu hale getirildi. Yönlendirme sosyalkopru.com olarak güncellendi.
Sidebar yazı boyutları büyütüldü: sayfa linkleri 13px → 15px, ikonlar 13×13px → 16×16px, bölüm başlıkları 10.5px → 12px.
12 Haziran 2026
GET /v1/analytics endpoint’ine platform ve date_range filtreleri eklendi.
Webhook payload’larına retry_count ve next_retry_at alanları eklendi.
Tüm tarih/zaman alanları artık ISO 8601 + UTC formatında döndürülüyor.
422 Unprocessable Entity hata mesajları daha açıklayıcı hale getirildi.
5 Haziran 2026
Medya API yayında: POST /v1/media ile görsel ve video yükleme desteği.
POST /v1/posts artık scheduled_at ile anlık veya planlı yayınlamayı destekliyor.
Yeni hata kodu: 429 Too Many Requests (rate limit).
API anahtarı prefix’leri zorunlu hale geldi (sk_test_ / sk_live_).
Webhook imza doğrulaması HMAC-SHA256 + timestamp ile güçlendirildi.
Eski /v1/accounts/connect endpoint’i kaldırıldı (yerine POST /v1/accounts).
12 Mayıs 2026
PATCH /v1/posts/{id} ile status alanının yanlış sıfırlanması sorunu giderildi.
Analitik verilerinde negatif etkileşim sayıları sorunu çözüldü.
Hata kodları artık tutarlı formatta (INVALID-TOKEN gibi).
28 Nisan 2026
API’nin ilk kararlı sürümü (v1.0.0) yayınlandı.
Temel endpoint’ler ve Bearer token kimlik doğrulama (sk_test_ / sk_live_) eklendi.
Tüm önemli değişiklikler burada yayınlanacaktır. Soru veya önerileriniz için destek ile iletişime geçebilirsiniz.