Yanıt Zarfı

Her JSON yanıtı (başarı veya hata) bir status ayırıcısı taşır; bu sayede dallanma diller arasında trivially typed kalır.

Başarı

{
  "status":  "success",
  "data":    { /* endpoint'e özel payload */ },
  "message": "Operation completed successfully",
  "warnings": []
}

warnings[] opsiyoneldir. Mevcut olduğunda, ölümcül olmayan uyarılar taşır (örn. kısmi config rollback bildirimleri, kullanımdan kaldırılmış parametre kullanımı). Uyarıları bilgilendirici olarak ele alın, hata olarak değil.

Hata

{
  "status":     "error",
  "error_code": "ACCOUNT_NOT_FOUND",
  "message":    "Account 'alice' does not exist",
  "details":    { /* opsiyonel yapılandırılmış bağlam */ }
}

error_code asıl makine tanımlayıcısıdır; istisna yönetimini yerelleştirilmiş message'a değil bu alana eşleyin. Tam katalog Ek A bölümünde yer alır.