Bayi / Alt Bayi Kullanıcısı Listeleme & Detay Getirme

Endpoint

• Tüm kullanıcıları listeleme: GET /vendor/users
• Tek kullanıcı detayını getirme: GET /vendor/users/{userCode}

HTTP Method: GET
Request Content-Type: application/json
Response Content-Type: application/json
Yetkilendirme: Geçerli AccessToken zorunludur.
(Bkz: 2. Kimlik Doğrulama – AccessToken Alınması)

Açıklama

Bu servis, sistemdeki tüm bayi ve alt bayi kullanıcılarını listelemek veya tek bir kullanıcının detayını görüntülemek için kullanılır.

Filtre parametreleri ile belirli bir bayi veya kullanıcı grubu hedeflenebilir.

Not

• Tek bir kullanıcı detayı almak için userCode route parametresi kullanılmalıdır.
• Parametre verilmezse sistem, tüm kullanıcıları sayfalandırmalı olarak döndürür.

Header Bilgileri

Header Adı	Zorunlu	Açıklama
Authorization	Evet	Bearer {AccessToken} formatında geçerli token
Content-Type	Evet	application/json

Route Parametresi – Tek Kayıt Getirme

Parametre	Tip	Zorunlu	Açıklama
userCode	string	Evet	Detayı alınacak kullanıcının kodu

Query Parametreleri – Filtreleme / Listeleme

Parametre	Tip	Zorunlu	Açıklama
DealerCode	string	Hayır	Belirtilirse sadece ilgili bayinin kullanıcıları listelenir.
isActive	boolean	Hayır	Aktif/pasif kullanıcı filtrelemesi.
isAdmin	boolean	Hayır	Yönetici kullanıcı filtrelemesi.
page	integer	Hayır	Sayfa numarası (varsayılan: 1).
pageSize	integer	Hayır	Sayfa başına kayıt sayısı (varsayılan: 20, maksimum: 100).

Örnek Request – Listeleme
GET /vendor/users?dealerCode=MD001&isActive=true&page=1&pageSize=10

Örnek Request – Tek Kayıt
GET /vendor/users/USR1001

Başarılı Response (200 OK)

{  
  "status": "success",  
  "totalCount": 2,  
  "data": [  
    {  
      "dealerCode": "MD001",  
      "userCode": "USR1001",  
      "memberId": "fbb9d6c7-5e1e-4a5f-b9d4-ccfabc123456",  
      "name": "John",  
      "surname": "Doe",  
      "email": "[email protected]",  
      "gsm": "+905000000000",  
      "isActive": true,  
      "sendRegisterMail": false,  
      "tckn": "00000000000",  
      "isAdmin": false,  
      "isMobileActive": true,  
      "ruleName": ["ROLE_USER"]  
    },  
    {  
      "dealerCode": "MD001",  
      "userCode": "USR1002",  
      "memberId": "6d3e2410-9a78-4b89-bb9d-b91ff671ab45",  
      "name": "John",  
      "surname": "Doe",  
      "email": "[email protected]",  
      "gsm": "+905000000000",  
      "isActive": true,  
      "sendRegisterMail": true,  
      "tckn": "00000000000",  
      "isAdmin": true,  
      "isMobileActive": false,  
      "ruleName": ["ROLE_ADMIN"]  
    }  
  ]  
}

Not: Tek bir kullanıcı çağrısında (GET /vendor/dealerusers/{userCode}), data alanı yerine tek bir kullanıcı objesi dönebilir.

Notlar & En İyi Uygulamalar

• dealerCode parametresi verilirse sadece o bayiye/alt bayiye ait kullanıcılar döner.
• isActive, isAdmin gibi filtreler birlikte kullanılabilir.
• Sayfalama parametreleri verilmezse sistem varsayılan olarak page=1, pageSize=20 ile çalışır.
• Tek kullanıcı sorgularında ({userCode}) sayfalama parametreleri dikkate alınmaz.
• Token süresi dolmuşsa istek 401 Unauthorized döner; yeni token alınmalıdır.
• Çok sayıda kullanıcı bulunan yapılarda lazy loading veya sayfa bazlı istek önerilir.