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"
}
}
codemakine içindir ve kararlıdır; programını buna göre yaz.messageinsan içindir, Türkçedir ve değişebilir.requestIdyanıttakiX-Request-Idbaş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
| HTTP | code | Ne zaman |
|---|---|---|
| 400 | bad_request | Geçersiz istek; mesaj geçersiz alanların adını söyler |
| 401 | unauthorized | Anahtar yok, geçersiz, süresi dolmuş ya da iptal edilmiş |
| 403 | forbidden | Yetki yetmiyor (anahtarın yetkisi, sahiplik, uygulama klasörü) |
| 404 | not_found | Öğe yok ya da erişimin yok (ikisi ayırt edilmez) |
| 409 | conflict | Durum uygun değil (ör. yükleme bitmedi, aynı Idempotency-Key ile istek sürüyor) |
| 409 | name_conflict | Aynı adda öğe var; suggestion boş bir ad önerir |
| 413 | quota_exceeded | Depolama alanın yetmiyor |
| 413 | too_large | Dosya tek dosya ya da basit yükleme sınırını aşıyor |
| 415 | unsupported_media | Bu tür tarayıcıda önizlenemez |
| 422 | size_mismatch | Yüklenen boyut bildirilenle uyuşmuyor |
| 422 | idempotency_mismatch | Aynı Idempotency-Key farklı bir istekle kullanılmış |
| 429 | rate_limited | Hız sınırı; Retry-After kadar bekle |
| 500 | internal | Beklenmeyen hata; requestId ile bildir |
Yeni kodlar eklenebilir (Sürümleme); tanımadığın bir kodu HTTP durumuna göre ele al.