GetIncomingLogPayload API

InsurGateway, bildirim tipi 4 ile platforma ilettiği incoming log gövdelerini ileride bu endpoint üzerinden geri ister.

Endpoint

Alan	Değer
HTTP Method	`POST`
Path	`/GetIncomingLogPayload`
Content-Type	`application/json`

Header’lar

Content-Type: application/json
x-api-key: <platform tarafından üretilen API key>
Authorization: <opsiyonel; platform tarafından bildirildiyse>

Request Yapısı

1 {
2   "ReferanceNo": "string",
3   "SubReferanceNo": "string",
4   "RequestKeyValueSet": null,
5   "RequestObject": {
6     "ReferenceNo": "0_12345_20260504120500999_7",
7     "IsResponse": false
8   }
9 }

Alan	Tip	Açıklama
`ReferanceNo`	string	Bu çağrı için iş referans numarası.
`SubReferanceNo`	string	Bu çağrıya özel ~30 karakterlik benzersiz alt referans.
`RequestKeyValueSet`	array\|null	Kullanılmaz.
`RequestObject.ReferenceNo`	string	Daha önce bildirim tipi `4` ile gönderilen log kaydının `ReferanceNo` değeri.
`RequestObject.IsResponse`	bool	`false`: gönderilen istek (`DataSent`). `true`: alınan cevap (`DataReceived`).

Dış zarftaki ReferanceNo (Türkçe yazım) ile içteki ReferenceNo (İngilizce yazım) yazımları kasıtlı olarak farklıdır.

Response Yapısı

Platformun döneceği cevap, HTTP 200 OK ile aşağıdaki yapıda olmalıdır:

1 {
2   "ResultStatus": {
3     "Status": "Success",
4     "Explanation": null
5   },
6   "Result": {
7     "ReferenceNo": "0_12345_20260504120500999_7",
8     "Payload": "<request veya response gövdesi>"
9   }
10 }

Alan	Açıklama
`ResultStatus.Status`	Yalnızca `"Success"` başarılı kabul edilir; diğerleri hata.
`ResultStatus.Explanation`	Hata açıklaması.
`Result.ReferenceNo`	İstekteki `ReferenceNo` değerinin aynısı döndürülür.
`Result.Payload`	`IsResponse=false` → `DataSent`; `true` → `DataReceived`.

Hata durumunda Result null veya boş olabilir.

Tam Örnek

İstek:

1 POST /insurgw/GetIncomingLogPayload HTTP/1.1
2 Host: platform.ornek.com.tr
3 Content-Type: application/json
4 x-api-key: 9f3c1e8a-2b4d-1234-5678-deadbeefcafe
5 
6 {
7   "ReferanceNo": "0_12345_QUERY_20260510153000_1",
8   "SubReferanceNo": "queryref-9f8e7d6c5b4a3210fedcba9876",
9   "RequestKeyValueSet": null,
10   "RequestObject": {
11     "ReferenceNo": "0_12345_20260504120500999_7",
12     "IsResponse": false
13   }
14 }

Başarılı cevap:

1 HTTP/1.1 200 OK
2 Content-Type: application/json
3 
4 {
5   "ResultStatus": { "Status": "Success", "Explanation": null },
6   "Result": {
7     "ReferenceNo": "0_12345_20260504120500999_7",
8     "Payload": "<request><Method>GetProposal</Method>...</request>"
9   }
10 }

Hata cevabı (log bulunamadı):

1 HTTP/1.1 200 OK
2 Content-Type: application/json
3 
4 {
5   "ResultStatus": { "Status": "Error", "Explanation": "Log bulunamadı" },
6   "Result": null
7 }