Sandbox Modu

Sandbox modu, gerçek sosyal medya hesaplarını veya kredi bakiyenizi etkilemeden API entegrasyonunuzu test etmenizi sağlar. Prefix’i sk_test_ ile başlayan her API anahtarı otomatik olarak sandbox modunda çalışır.

Nasıl Çalışır?

sk_test_ prefix’li bir anahtarla yapılan tüm istekler:

Gerçek veri yazmaz — post, medya, hashtag grubu oluşturma gibi POST işlemleri simüle edilir
Sahte yanıt döner — sandbox yanıtları gerçek üretim yanıtlarıyla aynı şemayı takip eder
Kredi %10 oranında harcanır — 5 kredi gerektiren bir işlem sandbox’ta 1 kredi kullanır
Rate limit %10 kapasiteyle çalışır — STARTER planı için dakikada 3 istek (normal: 30)
X-Sandbox: true header’ı her yanıta eklenir


Authorization: Bearer sk_test_a1b2c3d4e5f6...
 
HTTP/1.1 200 OK
X-Sandbox: true
X-Request-Id: req_abc123

Sandbox ile Production Farkları

Özellik	Sandbox (`sk_test_`)	Production (`sk_live_`)
Sosyal medyaya post atılır	❌ Hayır	✅ Evet
Gerçek medya yüklenir	❌ Hayır	✅ Evet
Kredi maliyeti	%10 oranında	Tam maliyet
Rate limit	%10 kapasitede	Tam kapasite
Yanıt şeması	Üretimle aynı	Üretimle aynı
`X-Sandbox` header	✅ Var	❌ Yok

Sandbox Yanıt Örneği

POST /v1/posts isteği sandbox modunda gerçek bir gönderi oluşturmadan şu yanıtı döner:


{
  "success": true,
  "data": {
    "id": "sandbox_post_1718445600000",
    "status": "scheduled",
    "accountIds": ["acc_abc123"],
    "scheduledAt": "2026-06-16T10:00:00.000Z",
    "sandbox": true
  },
  "meta": {
    "requestId": "req_m4p9x2",
    "timestamp": "2026-06-15T13:00:00.000Z",
    "version": "1.0"
  },
  "sandbox": true
}

Sandbox Anahtarı Oluşturma

Sosyal Köprü Dashboard → Ayarlar → API → Yeni Anahtar seçeneğinde anahtar türünü Test olarak seçin.

Sandbox anahtarlarını kaynak kodunuzda bırakmanız production’dan daha az riskli olsa da, tüm anahtarlarınızı güvende tutmak best practice’tir.

Programatik Sandbox Tespiti

Yanıtta sandbox: true alanını veya X-Sandbox: true header’ını kontrol ederek ortamı belirleyebilirsiniz:


const response = await fetch("https://api.sosyalkopru.com/api/v1/posts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SK_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ /* ... */ }),
});
 
const isSandbox = response.headers.get("X-Sandbox") === "true";
const data = await response.json();
 
if (isSandbox) {
  console.log("Sandbox modunda çalışıyor — gerçek veri yazılmadı.");
}