User Roles Create Endpoint

Bu sayfa, user_roles kaydı oluşturmak için düşünülen endpoint sözleşmesini tanımlar.

Önerilen Route

POST /v1/admin/user-roles

Amaç

Bu endpointin amacı, yeni bir user_roles kaydı oluşturmaktır.

Auth Gereksinimi

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

Request Body

{
  "user_id": 123,
  "role_id": 7,
  "is_active": true
}

Write Kuralı

• önce request validation yapılır
• ardından DB üzerinde create işlemi kesinleştirilir
• DB commit başarılı olduktan sonra ilgili Redis cache/projection yeniden oluşturulur veya refresh edilir
• DB authoritative source olarak kalır
• Redis write başarısız olsa bile DB write geri alınmaz; retry/rebuild stratejisi uygulanır

Ö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
Geçersiz body	400	VALIDATION_ERROR
Çakışan kayıt	409	CONFLICT
İç hata	500	INTERNAL_ERROR