Parameter Change API

InsurGateway’de parametre değeri kayıtlarına (ParameterValue) ait değerler eklendiğinde, güncellendiğinde veya silindiğinde, platformun kendi parametre havuzunu güncel tutabilmesi için gönderilen bildirim tipidir.

Hem tekil ekle/güncelle/sil işlemleri, hem de toplu güncellemeler (ör. TSB araç birlik listesi: marka 91 / tip 92 / model yılı 93 ve araç bedeli) bu bildirimi üretir. Payload her zaman aynı yapıdadır: ChangeType’a göre gruplanmış bir dizi; her grup Values içinde o tipteki değişen değerleri taşır. Tekil değişiklikte dizi tek grup / tek değer, toplu değişiklikte birden çok değer içerir.

Ortak kurallar (header, zarf) için: Platform Entegrasyon Gereksinimleri.

Endpoint

Örnek İstek

$
curl -X POST "https://platform.ornek.com.tr/insurgw/PushNotification" \
>
  -H "Content-Type: application/json" \
>
  -H "x-api-key: 9f3c1e8a-2b4d-1234-5678-deadbeefcafe" \
>
  -d '{
>
    "ReferanceNo": "10025_20260609153012345a1b2c_0_0",
>
    "SubReferanceNo": "a1b2c3d4-e5f6-7890abcdef1234567890",
>
    "RequestKeyValueSet": null,
>
    "RequestObject": {
>
      "NotificationType": 8,
>
      "Payload": "[{\"ChangeType\":\"updated\",\"Values\":[{\"ParameterId\":92,\"ParameterValue\":\"1\",\"ParameterName\":\"Otomobil\",\"Status\":true,\"Crossed\":false,\"Dependents\":[{\"ParameterId\":91,\"ParameterValue\":\"34\"}],\"AdditionalDetails\":[]},{\"ParameterId\":93,\"ParameterValue\":\"34521-2020\",\"ParameterName\":\"2020\",\"Status\":true,\"Crossed\":false,\"Dependents\":[{\"ParameterId\":92,\"ParameterValue\":\"1\"}],\"AdditionalDetails\":[{\"KeyId\":22,\"KeyName\":\"Araç Bedeli\",\"KeyValue\":\"150000\"}]}]}]"
>
    }
>
  }'

Parse Edilmiş Payload

RequestObject.Payload serialize edilmiş bir JSON string’tir; ikinci parse sonrası ChangeType’a göre gruplanmış bir diziye ulaşılır:

1
[
2
  {
3
    "ChangeType": "updated",
4
    "Values": [
5
      {
6
        "ParameterId": 92,
7
        "ParameterValue": "1",
8
        "ParameterName": "Otomobil",
9
        "Status": true,
10
        "Crossed": false,
11
        "Dependents": [
12
          { "ParameterId": 91, "ParameterValue": "34" }
13
        ],
14
        "AdditionalDetails": []
15
      },
16
      {
17
        "ParameterId": 93,
18
        "ParameterValue": "34521-2020",
19
        "ParameterName": "2020",
20
        "Status": true,
21
        "Crossed": false,
22
        "Dependents": [
23
          { "ParameterId": 92, "ParameterValue": "1" }
24
        ],
25
        "AdditionalDetails": [
26
          { "KeyId": 22, "KeyName": "Araç Bedeli", "KeyValue": "150000" }
27
        ]
28
      }
29
    ]
30
  }
31
]

Kök (dizi):

Values öğesi:

ChangeType="deleted" olduğunda Values, silinen kaydın son hâliyle gönderilir. Eşsiz kimlik (ParameterId, ParameterValue) ikilisidir. Araç bedeli (KeyId 22) model yılı (93) değerinde bulunur; tip (92) yalnızca marka (91) bağımlılığı taşır.

Beklenen Cevap

Başarı:

1
HTTP/1.1 200 OK
2
Content-Type: application/json
3
4
{ "ResultStatus": { "Status": "Success", "Explanation": null }, "Result": null }

Hata (retry tetikler):

1
HTTP/1.1 200 OK
2
Content-Type: application/json
3
4
{ "ResultStatus": { "Status": "Error", "Explanation": "Parametre değişikliği işlenemedi." }, "Result": null }

Retry