User Roles Detail Endpoint

Bu sayfa, user_roles tekil kayıt detayını okumak için düşünülen endpoint sözleşmesini tanımlar.

Önerilen Route

GET /v1/admin/user-roles/{id}

Amaç

Bu endpointin amacı, belirli bir user_roles kaydının tam detayını admin yüzüne sağlamaktır.

Auth Gereksinimi

• admin auth zorunlu
• JWT + session + auth context doğrulama zorunlu
• user_roles.read yetkisi zorunlu

Path Parametreleri

Alan	Zorunlu	Açıklama
id	Evet	user_roles tekil kayıt kimliği

Read Kuralı

• önce ilgili Redis cache/projection kontrol edilir
• cache yoksa veya stale ise DB fallback yapılır
• DB sonucu ile Redis cache yeniden oluşturulur veya güncellenir
• authoritative source DB'dir

Örnek Response

{
  "ok": true,
  "data": {
    "id": 91,
    "user_id": 123,
    "role_id": 7,
    "is_active": true,
    "created_at": "2026-04-20T06:00:00Z",
    "updated_at": "2026-04-20T06:00:00Z"
  },
  "error": null,
  "meta": {
    "request_id": "req_123",
    "timestamp": "2026-04-20T06:00:00Z"
  }
}

Hata Modeli

Durum	HTTP	error.code
Yetkisiz erişim	401	UNAUTHORIZED
Yetki yok	403	FORBIDDEN
Kayıt yok	404	NOT_FOUND
Geçersiz id	400	VALIDATION_ERROR
İç hata	500	INTERNAL_ERROR