Kredi Sistemi

Sosyal Köprü API, istek başına sabit ücret yerine kredi tabanlı bir kota sistemi kullanır. Her plan belirli miktarda kredi içerir; yapılan işlemler kredi tüketir.

Endpoint Kredi Maliyetleri

İşlem	Endpoint	Maliyet
Veri listeleme / okuma	`GET` (tüm endpoint’ler)	1 kredi
Anlık gönderi oluşturma	`POST /v1/posts` (scheduledAt yok)	5 kredi
Planlı gönderi oluşturma	`POST /v1/posts` (scheduledAt var)	1 kredi
Gönderi güncelleme	`PATCH /v1/posts/{id}`	1 kredi
Gönderi silme	`DELETE /v1/posts/{id}`	1 kredi
Gönderi kopyalama	`POST /v1/posts/{id}/duplicate`	1 kredi
Toplu gönderi	`POST /v1/posts/bulk`	Gönderi başına 1 kredi
Medya yükleme	`POST /v1/media/upload`	2 kredi
Analitik verileri	`GET /v1/analytics/*`	3 kredi
Webhook testi	`POST /v1/webhooks/{id}/test`	Ücretsiz
API meta bilgisi	`GET /v1/me`	Ücretsiz

Sandbox modunda (sk_test_) tüm maliyetler %10 olarak uygulanır. 5 kredi gerektiren anlık gönderi sandbox’ta yalnızca 1 kredi harcar.

Kredi Yanıt Bilgisi

Her API yanıtı meta alanında kredi kullanımını raporlar:


{
  "success": true,
  "data": { /* ... */ },
  "meta": {
    "requestId": "req_m4p9x2",
    "timestamp": "2026-06-15T13:00:00.000Z",
    "version": "1.0",
    "creditsUsed": 5,
    "creditsRemaining": 4815
  }
}

Yetersiz Kredi Hatası

Kredi bakiyesi sıfırlandığında API 402 Payment Required döner:


{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Bu işlemi gerçekleştirmek için yeterli krediniz yok.",
    "details": {
      "required": 5,
      "available": 3
    }
  }
}

Kullanım Durumunu İzleme

Güncel kredi bakiyenizi ve dönem istatistiklerini /v1/usage endpoint’i ile sorgulayabilirsiniz:


curl -X GET https://api.sosyalkopru.com/api/v1/usage \
  -H "Authorization: Bearer sk_live_..."


{
  "success": true,
  "data": {
    "plan": "GROWTH",
    "credits": {
      "total": 10000,
      "used": 1843,
      "remaining": 8157,
      "resetsAt": "2026-07-01T00:00:00.000Z"
    },
    "requests": {
      "today": 142,
      "thisMonth": 2891
    }
  }
}

Kredi Optimizasyon İpuçları

Batch işlemleri tercih edin: Tek tek gönderi oluşturmak yerine POST /v1/posts/bulk kullanın — toplu oluşturmada her gönderi yalnızca 1 kredi harcar.

Veri önbellekleme: Sık okunan analitik verilerini kendi sisteminizde önbelleğe alarak tekrar eden GET /v1/analytics/* çağrılarını azaltın (her biri 3 kredi).

Anlık yayın yerine planlama: Mümkünse gönderilerinizi scheduledAt ile planlayın — anlık yayın (5 kredi) yerine 1 kredi harcanır.

Kredi tüketimi audit log sistemine yazıldıktan sonra gerçekleşir. İstek başarısız olsa dahi, işlem gerçekleştirilmişse (örn. sosyal medyaya yazıldıysa) kredi harcanır.