Roles List Endpoint
Bu sayfa, roles kayıtlarının listelenmesi için düşünülen endpoint sözleşmesini tanımlar.
Amaç
Bu endpointin amacı, admin yüzünde roles kayıtlarını filtrelenebilir ve sayfalanabilir şekilde listelemektir.
Önerilen Route
GET /v1/admin/roles
Auth Gereksinimi
- admin auth zorunlu
- JWT doğrulama zorunlu
- session/auth context doğrulama zorunlu
- detaylı rol/yetki seviyesi daha sonra netleştirilecektir
Query Parametreleri
| Alan | Zorunlu | Açıklama |
|---|---|---|
limit | Hayır | Sayfa boyutu, varsayılan 50, max 200 |
cursor | Hayır | Cursor-based pagination için imleç |
q | Hayır | Role code/name araması |
is_active | Hayır | Aktif/pasif filtre |
sort | Hayır | Whitelist alanlarla sıralama |
Veri Kaynağı
Temel veri kaynağı:
roles
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
Hata Modeli
| Durum | HTTP | error.code |
|---|---|---|
| Yetkisiz erişim | 401 | UNAUTHORIZED |
| Yetki yok | 403 | FORBIDDEN |
| Geçersiz query | 400 | VALIDATION_ERROR |
| İç hata | 500 | INTERNAL_ERROR |