İçeriğe geç

Başvuru

Hatalar

Tek tip hata gövdesi, kod tablosu ve requestId.

Bütün hatalar aynı biçimdedir:

{
  "error": {
    "code": "name_conflict",
    "message": "Bu klasörde aynı adda bir öğe var.",
    "requestId": "4c1f2a8e-…",
    "suggestion": "rapor (1).pdf"
  }
}
  • code makine içindir ve kararlıdır; programını buna göre yaz.
  • message insan içindir, Türkçedir ve değişebilir.
  • requestId yanıttaki X-Request-Id başlığıyla aynıdır. Destek isterken bunu ver.
const BASE = "https://drive.kivilio.com";

const res = await fetch(`${BASE}/api/v1/nodes/00000000-0000-4000-8000-000000000000`, {
  headers: { Authorization: `Bearer ${process.env.KIVILIO_API_KEY}` },
});
if (!res.ok) {
  const { error } = await res.json();
  // error.code makine için (kararlı), error.message insan için (değişebilir).
  console.log(res.status, error.code, error.message, "istek:", error.requestId);
  if (res.status === 429) {
    const wait = Number(res.headers.get("Retry-After") ?? 1);
    console.log(`${wait} saniye sonra yeniden dene`);
  }
}

Kodlar

HTTPcodeNe zaman
400bad_requestGeçersiz istek; mesaj geçersiz alanların adını söyler
401unauthorizedAnahtar yok, geçersiz, süresi dolmuş ya da iptal edilmiş
403forbiddenYetki yetmiyor (anahtarın yetkisi, sahiplik, uygulama klasörü)
404not_foundÖğe yok ya da erişimin yok (ikisi ayırt edilmez)
409conflictDurum uygun değil (ör. yükleme bitmedi, aynı Idempotency-Key ile istek sürüyor)
409name_conflictAynı adda öğe var; suggestion boş bir ad önerir
413quota_exceededDepolama alanın yetmiyor
413too_largeDosya tek dosya ya da basit yükleme sınırını aşıyor
415unsupported_mediaBu tür tarayıcıda önizlenemez
422size_mismatchYüklenen boyut bildirilenle uyuşmuyor
422idempotency_mismatchAynı Idempotency-Key farklı bir istekle kullanılmış
429rate_limitedHız sınırı; Retry-After kadar bekle
500internalBeklenmeyen hata; requestId ile bildir

Yeni kodlar eklenebilir (Sürümleme); tanımadığın bir kodu HTTP durumuna göre ele al.