# 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ı

```json
{
  "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

```json
{
  "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](#ek-a--hata-kodlar) bölümünde yer alır.

---