İstek / Yanıt içeriği
Başarılı yanıt
{
"success": true,
"data": {},
"meta": null
}data: işleme özgü içerik (işlem nesnesi, özet alanlar vb.).meta: ek bilgi (bazı servislerde dolu olabilir).Hatalı yanıt (HTTPException)
{
"success": false,
"error": {
"code": "INVALID_STATUS_FOR_REFUND",
"message": "İade yalnızca başarılı (APPROVED/CAPTURED) işlemler için talep edilebilir.",
"http_status": 400,
"user_message": "İşleminiz şu anda tamamlanamadı. Lütfen tekrar deneyin.",
"field_errors": null,
"details": null
}
}code: sistem tarafından işlenecek kod (HTTPException.detail_code ile uyumludur).message: teknik/dahili açıklama.user_message: son kullanıcıya gösterilebilecek genel mesaj (varsa).field_errors: doğrulama hatalarında alan bazlı mesajlar.Doğrulama hatası (422)
code genelde VALIDATION_ERROR olur ve field_errors doludur.{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Şu alanlar hatalı: ...",
"http_status": 422,
"user_message": "Girdiğiniz bilgilerde hata var. Lütfen formu kontrol edip tekrar deneyin.",
"field_errors": {
"amount": "..."
},
"details": {
"errors": []
}
}
}ApiResponse ve ApiError tanımlarına bakın.