My Insurance Companies

My Insurance Companies

Token sahibinin yetkili olduğu sigorta şirketlerini şirket adına göre alfabetik sıralı düz dizi olarak döndürür.

Uç Nokta (Endpoint)

GET {{baseUrl}}/api/InsuranceCompanies/MyInsuranceCompanies

Kullanım

Bu servis, sigorta şirketi kimliği bekleyen diğer servisler çağrılmadan önce geçerli insuranceCompanyId değerlerini öğrenmek için kullanılır. Önerilen akış:

1. Authentication Login servisinden token alınır.
2. Bu servis çağrılarak yetkili olunan şirketlerin listesi alınır.
3. Dönen Id değeri, sigorta şirketi kimliği bekleyen diğer servislerde (insuranceCompanyId) doğrudan kullanılır.

Servis parametre almaz ve sayfalanmaz; yetki kapsamı yalnızca token’dan çözülür. Liste, token’daki role göre farklı kaynaktan üretilir:

💡 Şirket kümesi yalnızca yetki tanımları değiştiğinde değişir; her istek öncesi çağrılması gerekmez.

⚠️ Yanıt kullanıcıya özeldir. Önbelleklenecekse kullanıcı bazında önbelleklenmeli, ortak/global önbellekte tutulmamalıdır.

Kimlik Doğrulama

Bu uç nokta geçerli bir JWT erişim token’ı gerektirir. Token, Authentication Login servisinden alınır ve Authorization başlığında gönderilir.

Token’ın Read yetkisini taşıması gerekir.

Başarılı Yanıt (200 OK)

Şirket adına göre alfabetik sıralı düz dizi (array) döner.

Örnek Başarılı Yanıt:

[
  {
    "Id": 2,
    "Name": "Deneme Sigorta"
  },
  {
    "Id": 7,
    "Name": "Örnek Hayat ve Emeklilik"
  },
  {
    "Id": 11,
    "Name": "Örnek Sigorta"
  }
]

Hatalı Yanıt (400 Bad Request)

Kullanıcının yetki kümesi boş kaldığında düz metin gövdeyle döner. Bu bir sistem hatası değil, kullanıcının yetki tanımının eksik olduğu anlamına gelir.

Örnek Hatalı Yanıt:

Yetkili olduğunuz bir sigorta şirketi bulunamadı.

Hatalı Yanıt (401 Unauthorized)

Token gönderilmediğinde, geçersiz olduğunda veya süresi dolduğunda HTTP 401 Unauthorized döner. Yanıt gövdesi boştur.

💡 Token’ın süresi dolduysa yanıtta Token-Expired: true başlığı bulunur. Bu durumda POST /api/authentication/refreshtoken ile yeni token alınmalıdır.