Hatalar

Her durumun anlamı ve güvenli tekrar deneme.

Hatalar { "error": "…" } ve bir insana gösterebileceğin bir cümleyle döner.

Durum kodları

Durum	Anlamı
`401`	API anahtarı eksik, bozuk veya iptal edilmiş.
`400`	İstek gövdesi hatalı — mesaj hangi alan olduğunu söyler.
`404`	Kayıt başkasına ait ya da hiç yok. İkisi bilerek aynı cevabı verir.
`413`	Depo kotası dolu. Panelden eski medyayı sil ya da yayınlanan dosyaların otomatik temizliğini bekle.
`429`	Bu adresten çok fazla istek. Retry-After başlığı kaç saniye bekleyeceğini söyler.
`409`	Durum izin vermiyor: 24 saatlik cevap penceresi kapandı, hesap artık bağlı değil ya da kaynak meşgul.

Tekrar denemeyi hata ayrıştırmaya değil idempotency'ye kur

Ağ hatası, yavaş başarıdan ayırt edilemez. /v1/posts'a idempotencyKey gönder ve korkmadan tekrar dene: zaten başarılı olmuş istek, kopya açmak yerine mevcut gönderiyi existingPost altında döndürür.

Bir şey düştüğünde nereye bakılır

GET /v1/posts/{id} içinde hedefin error alanı — hedef başına tam sebep.
Kayıtlıysa post.failed webhook'u — aynı sebep, sana itilmiş hâlde.
Panelin Kule ve Kayıtlar ekranları.