Service Availabilities

Kullanıma açık servis operasyonlarını güncel statüleriyle sayfalı döndürür.

Uç Nokta (Endpoint)

GET {{baseUrl}}/api/ServiceAvailabilities

Kullanım

Bu servis, sigorta şirketi servislerinin anlık kullanılabilirlik durumunu kendi tarafında izlemek isteyen tüketiciler için kullanılır. Önerilen akış:

Authentication Login servisinden token alınır.
Bu servis page=1 ile çağrılır ve page değeri HasNextPage false olana kadar artırılır.
Status değeri Active olmayan kayıtlar için StatusReason ve StatusChangedAt okunur.

💡 Tek bir şirketle ya da acenteyle ilgileniyorsanız tüm kataloğu tarayıp süzmek yerine companies/:insuranceCompanyId ya da agents/:agentId uçlarını kullanın.

⚠️ pageSize 1–200 aralığı dışındaysa sessizce kırpılmaz; istek 400 ile sonuçlanır.

⚠️ LastSuccessDate günlük çalışan toplama işiyle güncellenir; anlık bir değer değildir.

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.

Başlık	Tür	Zorunlu	Açıklama
`Authorization`	string	✅	`Bearer <token>` biçiminde erişim token’ı.

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

İstek Parametreleri (Query Parameters)

Parametre	Tür	Zorunlu	Min	Max	Açıklama
`page`	integer (int32)	—	1	2147483647	1 tabanlı sayfa numarası. Varsayılan `1`.
`pageSize`	integer (int32)	—	1	200	Sayfa başına kayıt sayısı. Varsayılan ve üst sınır `200`; aralık dışı değerler `400` döner.

Örnek İstek:

GET {{baseUrl}}/api/ServiceAvailabilities?page=1&pageSize=2
Authorization: Bearer <token>

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

Alan	Tür	Açıklama
`TotalCount`	integer	Toplam kayıt sayısı (tüm sayfalar).
`Page`	integer	Dönen sayfa numarası (1 tabanlı).
`Size`	integer	Uygulanan sayfa boyutu.
`TotalPage`	integer	Toplam sayfa sayısı.
`HasNextPage`	boolean	Sonraki sayfanın olup olmadığı.
`HasPreviousPage`	boolean	Önceki sayfanın olup olmadığı.
`Items`	array	İstenen sayfanın kayıtları.

Items nesnesi:

Alan	Tür	Açıklama
`InsuranceCompanyId`	integer	Kaydın sigorta şirketi kimliği.
`ProductId`	integer \| null	Kaydın ürün kimliği. Ürün bağımsız operasyonlarda `null`.
`ServiceOperationId`	integer	Kaydın servis operasyonu kimliği.
`OutsourceProcessId`	integer \| null	Kaydın outsource süreci kimliği. Outsource olmayan operasyonlarda `null`; aynı operasyon farklı süreçler için ayrı kayıt üretir.
`InsuranceCompanyName`	string	Sigorta şirketi adı.
`ProductName`	string	Ürün adı. Ürün bağımsız operasyonlarda `Tüm Ürünler`.
`ServiceName`	string	Operasyonun ait olduğu servis adı.
`ServiceOperationName`	string	Servis operasyonu adı.
`OutsourceProcessName`	string \| null	Outsource süreci adı. Outsource olmayan operasyonlarda `null`.
`ExcludedProductIds`	array	Ürün bağımsız operasyonun kapsamı dışında bırakılan ürün kimlikleri. Ürünlü kayıtlarda boş dizi.
`Status`	string	Güncel statü: `Active`, `AutoDisabled`, `ManualDisabled` ya da `Unknown`.
`StatusReason`	string \| null	Son statü değişikliğinin gerekçesi. Hiç değişiklik olmadıysa `null`.
`StatusChangedAt`	datetime \| null	Son statü değişikliğinin zamanı. Hiç değişiklik olmadıysa `null`.
`LastSuccessDate`	datetime \| null	Gözlemlenen son başarılı işlemin zamanı. Henüz gözlem yoksa `null`.

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

{
  "TotalCount": 348,
  "Page": 1,
  "Size": 2,
  "TotalPage": 174,
  "HasNextPage": true,
  "HasPreviousPage": false,
  "Items": [
    {
      "InsuranceCompanyId": 12,
      "ProductId": null,
      "ServiceOperationId": 305,
      "OutsourceProcessId": null,
      "InsuranceCompanyName": "Örnek Sigorta",
      "ProductName": "Tüm Ürünler",
      "ServiceName": "PolicyService",
      "ServiceOperationName": "PolicyDetail",
      "OutsourceProcessName": null,
      "ExcludedProductIds": [
        44
      ],
      "Status": "Active",
      "StatusReason": null,
      "StatusChangedAt": null,
      "LastSuccessDate": "2026-08-10T09:12:44.13+03:00"
    },
    {
      "InsuranceCompanyId": 12,
      "ProductId": 27,
      "ServiceOperationId": 118,
      "OutsourceProcessId": null,
      "InsuranceCompanyName": "Örnek Sigorta",
      "ProductName": "Kasko",
      "ServiceName": "ProposalService",
      "ServiceOperationName": "Teklif",
      "OutsourceProcessName": null,
      "ExcludedProductIds": [],
      "Status": "AutoDisabled",
      "StatusReason": "Son 30 dakikada başarılı işlem üretilmedi.",
      "StatusChangedAt": "2026-08-10T10:05:00+03:00",
      "LastSuccessDate": "2026-08-10T09:31:07.44+03:00"
    }
  ]
}

Hatalı Yanıt (400 Bad Request)

Hatalar ApiResponse zarfıyla döner:

Alan	Tür	Açıklama
`Status`	boolean	Hatalarda her zaman `false`.
`Code`	string	Hata kodu. Sayfalama doğrulamalarında `Validation.General`.
`Message`	string	Hata açıklaması.
`Response`	array \| null	Doğrulama hatalarında `{ Field, Message }` listesi; diğer hatalarda `null`.

Sayfalama doğrulama hatası — page 1’den küçük ya da pageSize 1–200 aralığı dışında olduğunda:

Field	Message
`Page`	`Page must be greater than or equal to 1.`
`PageSize`	`PageSize must be between 1 and 200.`

{
  "Status": false,
  "Code": "Validation.General",
  "Message": "One or more validation errors occurred",
  "Response": [
    {
      "Field": "PageSize",
      "Message": "PageSize must be between 1 and 200."
    }
  ]
}

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.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

pageintegerOptional

1 tabanlı sayfa numarası.

pageSizeintegerOptional

Sayfa başına kayıt sayısı.

Response headers

Content-TypestringOptional

Response

Errors

400

Bad Request Error