Hata Kodları ve Yanıt Formatı

{
  "success": true,
  "data": { ... },
  "meta": {
    "requestId": "req_01HZGK9P3QABCD",
    "timestamp": "2025-06-10T12:00:00.000Z",
    "version": "1",
    "sandbox": false
  }
}

{
  "success": true,
  "data": [ ... ],
  "meta": {
    "requestId": "req_01HZGK9P3QABCD",
    "timestamp": "2025-06-10T12:00:00.000Z",
    "version": "1"
  },
  "pagination": {
    "page": 1,
    "perPage": 20,
    "total": 142,
    "totalPages": 8,
    "hasNextPage": true,
    "hasPrevPage": false
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Geçersiz istek verisi.",
    "details": {
      "platforms": ["En az bir platform seçilmelidir."],
      "accountIds": ["En az bir hesap ID'si gereklidir."]
    },
    "docsUrl": "https://docs.sosyalkopru.com/giris/hata-kodlari"
  }
}

async function apiCall(url, options, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch(url, options)
 
    if (response.ok) return response.json()
 
    const body = await response.json()
 
    // Hız limiti — Retry-After başlığını bekle
    if (response.status === 429) {
      const wait = parseInt(response.headers.get('Retry-After') ?? '60') * 1000
      await new Promise(r => setTimeout(r, wait))
      continue
    }
 
    // Servis kesintisi
    if (response.status === 503) {
      await new Promise(r => setTimeout(r, 5000))
      continue
    }
 
    // Sunucu hatası — exponential backoff
    if (response.status >= 500 && attempt < maxRetries - 1) {
      await new Promise(r => setTimeout(r, 2 ** attempt * 1000))
      continue
    }
 
    // Kurtarılamaz hata (4xx)
    throw Object.assign(new Error(body.error?.message ?? 'API hatası'), {
      code: body.error?.code,
      status: response.status,
    })
  }
  throw new Error('Maksimum yeniden deneme sayısına ulaşıldı')
}

const response = await fetch('/v1/media/media_01XYZ', { method: 'DELETE', headers })
 
if (response.status === 409) {
  const { error } = await response.json()
  // error.message: "Bu medya 3 aktif gönderide kullanılıyor."
  console.error('Çakışma:', error.message)
}

const { data } = await fetch(
  `https://api.sosyalkopru.com/v1/posts/${postId}/status`,
  { headers }
).then(r => r.json())
 
for (const platform of data.platforms) {
  if (platform.status === 'FAILED') {
    console.error(`${platform.platform}: ${platform.errorMessage}`)
    // Örnek: "Erişim tokenı süresi doldu — hesabı yeniden bağlayın"
  }
}