Get Job Actions

Get Job Actions

Belirtilen işe (jobId) ait tüm aksiyon kayıtlarını — mesajlar, prim/poliçe/zeyil talepleri, red ve onay adımları — en yeni kayıt başta olmak üzere sayfalanmış biçimde döner.

Uç Nokta (Endpoint)

GET {{baseUrl}}/api/offline/jobs/{jobId}/actions

Kullanım

Bir işin aksiyon geçmişini okumak ve tekil aksiyon detaylarına inmeden önce hangi kayıtların bulunduğunu görmek için kullanılır. Önerilen akış:

1. Authentication Login servisinden token alınır.

2. Jobs servisinden ilgilenilen işin jobId değeri elde edilir.

3. Bu servis çağrılarak işin aksiyon listesi sayfalanmış hâlde alınır.

4. Listedeki bir kaydın detayına inmek için kaydın Id değeri ile Get Job Action By Id çağrılır.

5. Bir aksiyonun hangi alanlarla (RequestDetails) oluşturulduğu gerekiyorsa kaydın ActionType değeri ile Get Job Action By Stage çağrılır.

💡 Kayıtlar Id alanına göre azalan sırada döner; Page = 1 her zaman en yeni aksiyonları içerir.

⚠️ Message ve Attachments alanları Platform tarafındaki mesaj servisinden zenginleştirilir. Platform servisi yanıt vermezse istek yine 200 OK döner, ancak bu iki alan boş kalır. Bu nedenle boş Message değerini “mesaj yok” olarak yorumlamayın.

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.

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

⚠️ İş, her hâlükârda token’daki sigorta şirketi kapsamıyla sınırlıdır. Kapsam dışındaki bir jobId için servis 403 değil 404 Not Found döner; bu, şirket dışı iş kimliklerinin varlığının sızmasını engeller.

İstek Parametreleri

Rota (Route) Parametreleri

Sorgu (Query) Parametreleri

Örnek İstek:

GET {{baseUrl}}/api/offline/jobs/100931/actions?page=1&pageSize=10
Authorization: Bearer <token>

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

Yanıt gövdesi PagedData yapısındadır.

⚠️ API Newtonsoft.Json DefaultContractResolver ile serileştirilir; alan adları C# property adlarıyla aynı, yani PascalCase döner (TotalCount, Items, JobId …). camelCase bekleyen bir istemci alanları null görür.

Items nesnesi (JobActionDTO):

MessageFrom / MessageTo değerleri (MessageSentBy):

Attachments nesnesi (OfflineAttachmentDTO):

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

{
  "TotalCount": 25,
  "Page": 1,
  "Size": 10,
  "TotalPage": 3,
  "HasNextPage": true,
  "HasPreviousPage": false,
  "Items": [
    {
      "Id": 1234,
      "JobId": 100931,
      "AgentId": 42,
      "CreateDate": "2026-05-13T10:30:00",
      "Message": "Eksik belge nedeniyle teklif reddedilmiştir.",
      "ToFullName": "Ahmet Yılmaz",
      "FromFullName": "InsurCo API User",
      "MessageFrom": 0,
      "MessageTo": 1,
      "Attachments": [],
      "PlatformProposalId": "PROP-001",
      "ActionType": 2
    }
  ]
}

Hatalı Yanıt (400 Bad Request)

Doğrulama hatalarında gövde standart hata zarfıdır ve Response alanı alan bazlı detayları taşır:

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

Olası doğrulama mesajları:

⚠️ 400 yanıtı üç farklı gövde biçiminde gelebilir: (1) yukarıdaki JSON zarfı — iş kuralı doğrulaması; (2) düz metin — page/pageSize sayısal olmayan bir değer olduğunda model binding hatası; (3) düz metin (İşlem sırasında bir hata oluştu! RequestId: …) — beklenmeyen sunucu hatası [HandleException] filtresi tarafından 400’e çevrildiğinde. İstemcide gövdeyi JSON olarak ayrıştırmadan önce Content-Type kontrol edilmelidir.

Hatalı Yanıt (401 Unauthorized)

Token gönderilmediğinde, geçersiz olduğunda veya süresi dolduğunda 401 Unauthorized döner. Yanıt gövdesi boştur; bilgi WWW-Authenticate başlığındadır.

💡 Token’ın süresi dolduğunda yanıta Token-Expired: true başlığı eklenir. İstemci bu başlığı görürse Refresh Token servisiyle token’ı yenileyip isteği tekrarlamalıdır.

Hatalı Yanıt (403 Forbidden)

İki farklı nedenden dolayı oluşur:

1. Rol yetersizliği — çağıranın InsuranceCompanyAPIUser, InsuranceCompanyAPIAdmin veya Supervizor rollerinden hiçbiri yoksa. Gövde boştur.

2. Token/erişim kontrolü — gövde standart hata zarfıdır:

{
  "Status": false,
  "Code": "OfflineJobs.JobOwnershipDenied",
  "Message": "You do not have permission to access this job.",
  "Response": null
}

Hatalı Yanıt (404 Not Found)

İş bulunamadığında veya iş token’daki sigorta şirketi kapsamı dışında olduğunda döner.

{
  "Status": false,
  "Code": "OfflineJobs.JobNotFound",
  "Message": "No job found for the requested JobId: 999999.",
  "Response": null
}