Toggle User Status

Kullanıcı Durumunu Değiştir

Offline kapsamındaki mevcut bir kullanıcının aktif/pasif durumunu tersine çevirir (toggle). Bu endpoint; sigorta şirketlerinin veya acentelerin kendi kapsamlarındaki bir kullanıcıyı pasifleştirmesine veya yeniden aktifleştirmesine olanak tanır. Endpoint kullanıcıyı silmez veya yeni kayıt oluşturmaz; yalnızca Disabled alanının değerini tersine çevirir. İstek; kimlik kapsamı çözümlemesi ve hedef kullanıcı erişim kontrolünden sonra durum değişikliğini gerçekleştirir.

Endpoint Bilgisi

Yetkilendirme Rolleri

Çağıranın aşağıdaki rollerden birine sahip olması gerekir:

Not: Endpoint Update policy’si ile korunur. Bu rollere sahip olmayan kullanıcılar 403 Forbidden alır.

Route Parametreleri

İstek Gövdesi

Bu endpoint istek gövdesi kabul etmez. Değiştirilecek kullanıcı yalnızca route parametresi üzerinden belirtilir.

Toggle Davranışı: Endpoint hedef alınan kullanıcının mevcut durumuna göre işlem yapar: aktif kullanıcı pasife, pasif kullanıcı aktife çevrilir. İstekte hedef durum bilgisi gönderilmez.

İstek Örneği

PATCH /api/offline/users/ae116cd4-a26e-47ab-8b0f-07d5ac9cb79c/status
Authorization: Bearer {token}

Yanıt Formatı

Başarılı Yanıt

HTTP Durumu: 204 No Content

Başarılı işlemde yanıt gövdesi boştur.

HTTP/1.1 204 No Content

Hata Yanıtı

{
    "Status": false,
    "Code": "Error.Code",
    "Message": "Error description",
    "Response": null
}

HTTP Durum Kodları

Hata Kodları Referansı

İşleme Akışı

Endpoint, isteği aldığında aşağıdaki adımları sırasıyla uygular:

1. Kimlik Doğrulama — Bearer token doğrulanır; token yoksa/geçersizse 401 döner.

2. Yetkilendirme — Update policy’si ve InsuranceCompanyAPIAdmin / Supervizor rolü kontrol edilir; yetersizse 403 döner.

3. Id Kontrolü — Route’taki id parametresi boş veya geçersizse OfflineUsers.IdRequired koduyla 400 döner.

4. Identity Scope Çözümleme — Token claim’lerinden InsuranceCompanyIds (company) veya AgentId (agent) okunur. Uygun rol/scope yoksa 403 döner.

5. Hedef Kullanıcı Erişim Kontrolü — Company scope için ve agent scope için erişim kontrolü yapılır. Hedef kullanıcı kapsam dışındaysa OfflineUsers.NotAccessible ile 403 döner.

6. Durum Toggle İşlemi — Business katmanında kullanıcının Disabled alanı tersine çevrilir ve Identity güncellemesi yapılır.

7. Sonuç — Başarıyla güncellenirse 204 No Content döner. Identity güncellemesi başarısız olursa OfflineUsers.ToggleStatusFailed koduyla 500 döner.

Notlar

• Toggle Semantiği: Endpoint hedef durumu kendi belirler; mevcut durumun tersine çevirir. Bir kullanıcıyı belirli bir duruma (örn. yalnızca pasif yapmak) set etmek için tasarlanmamıştır. Çağıran taraf, mevcut durumu bildiği varsayımıyla işlemi tetiklemelidir.

• Silme Değil, Pasifleştirme: Bu endpoint kullanıcıyı silmez. Yalnızca Disabled sütununu günceller. Pasifleştirilen kullanıcı sisteme giriş yapamaz ancak verisi korunur.

• Identity Scope: İşlem, yalnızca çağıran tokenın kapsamındaki (şirket veya acente) kullanıcılar üzerinde yapılabilir. Kapsam dışındaki kullanıcılara yapılan istekler OfflineUsers.NotAccessible ile reddedilir.

• İstek Gövdesi: Bu endpoint body kabul etmez. Gönderilen gövde yok sayılır; yalnızca route parametresi olan id dikkate alınır.