Talep

Bazı sigorta tipleri teklif vermez; bu tiplerde alıcının bilgilerini talep olarak, sağlayıcı bağlantınız üzerinden sağlayıcınıza iletirsiniz. Talebi POST /api/v1/insurance/leads ile açarsınız; sonucunu talep ucundan ve webhook ile izlersiniz.

• Talep bir iletimdir. Lunixi talebi sağlayıcınıza iletir ve iletimin sonucunu gösterir. Talepte teklif, prim, tahsilat, poliçe ve belge yoktur; sonraki adım (alıcıyla iletişim, teklif) sağlayıcıdadır ve talepte yer almaz.
• Talep yalnızca API yolundadır. Checkout Form'da ve ödeme linkinde talep yoktur.
• Talep ödemeye bağlanmaz. Talepte tutar, para birimi, sepet kalemi ve ödeme yoktur.

Kimlik doğrulama ve imzalama: Akışlar › Kimlik doğrulama.

Talep tipleri

Talep açabilmeniz için:

• Tip hesabınızda açık olmalı ve sigortayı API yolunda kullanıyor olmalısınız.
• Bağlantılarınızda bu tip için talep alan, açık bir sağlayıcı ürünü bulunmalıdır.

Koşullardan biri karşılanmazsa istek 412 insurance.type.not_available döner. Yalnızca talep alan tipler (CARGO_TRANSIT) teklif vermediği için uygunluk listesinde yer almaz ve teklif istekleri 412 insurance.type.not_available alır.

MOTOR_THIRD_PARTY_LIABILITY ve MOTOR_COMPREHENSIVE teklif de verir: Sigorta Tipleri › MOTOR_THIRD_PARTY_LIABILITY, MOTOR_COMPREHENSIVE. Talep ve teklif bağlantılarınızdaki ayrı ürünlerle çalışır: talep için talep alan, teklif için teklif veren bir ürün gerekir.

Akış

Talep açma: POST /api/v1/insurance/leads

Idempotency-Key zorunludur. Bkz. Tekrar ve Idempotency-Key.

• Alanlar ve zorunlulukları tipin talep şemasındadır: Talep şemaları. Şemada olmayan bir alan reddedilir.
• Bütün alan ihlalleri tek bir 422 insurance.validation.invalid yanıtında döner; ihlal varsa talep açılmaz ve sağlayıcıya istek gitmez.
• Biçimler: Veri Biçimleri.

MOTOR_COMPREHENSIVE için bir talep isteği. Değerler örnektir; açılı parantez içindeki değerlerin yerine alıcınızın bilgilerini yazın:

{
  "insuranceType": "MOTOR_COMPREHENSIVE",
  "policyholder": {
    "identityType": "TCKN",
    "identityNumber": "<kimlik numarası>",
    "birthDate": "<YYYY-MM-DD>",
    "email": "<e-posta>",
    "phone": "<E.164 telefon>"
  },
  "vehicle": {
    "plate": "<plaka>",
    "registrationDocument": {
      "serial": "<seri kodu>",
      "number": "<ruhsat numarası>"
    }
  },
  "note": "<talep notu>"
}

source lunixi-sign.sh
BODY='<talep isteği, boşluksuz JSON>'
lunixi_sign POST "/api/v1/insurance/leads" "$BODY"
 
curl -X POST "https://api-gateway.lunixi.com/api/v1/insurance/leads" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: insurance-lead-1001" \
  -H "X-Key-Id: $LUNIXI_KEY_ID" \
  -H "X-Date: $DATE" \
  -H "X-Nonce: $NONCE" \
  -H "Digest: $DIGEST" \
  -H "X-Signature: $SIGNATURE" \
  --data-raw "$BODY"

CARGO_TRANSIT talebinin alanları ve örneği: Sigorta Tipleri › CARGO_TRANSIT.

Yanıt

İstek tamamlandığında 201 ve data içinde talep nesnesini döner. Sağlayıcı talebi aldıysa status SUBMITTED, sonuç bilinmiyorsa UNKNOWN olur.

Sonuçlar

details.leadId hata yanıtında talebin kimliğini taşır; talebi okuma ucundan görebilirsiniz. İşlem beklenmedik bir hatayla yarıda kalırsa yanıt 500 insurance.internal.integrity olur ve talep UNKNOWN görünür.

Tekrar ve Idempotency-Key

• Talep sağlayıcıya aynı istekte iletilir. İstek 45 saniyeye kadar sürebilir; istemcinizin zaman aşımını buna göre ayarlayın.
• Zaman aşımı ya da 5xx sonrasında yanıtı alamadıysanız isteği aynı Idempotency-Key ve aynı gövdeyle tekrarlayın. Talep ilk denemede açıldıysa yeni talep açılmaz; mevcut talep güncel durumuyla döner ve sağlayıcıya yeniden gönderilmez.
• Aynı anahtar, talebin durumu ne olursa olsun aynı talebi döner. FAILED ya da UNKNOWN bir talebi yeniden göndermek için yeni bir anahtar üretin. UNKNOWN bir talebi yeniden göndermek sağlayıcıda ikinci bir talep açabilir.
• Aynı anahtarı farklı bir istekle (başka tip, sürüm ya da gövde) kullanırsanız 409 insurance.idempotency.conflict döner.

Talep nesnesi

Talepte sağlayıcının adı, kodu, ham mesajı ve talep referansı bulunmaz.

Durumlar

SUBMITTED ve FAILED kesin durumlardır; değişmez. Sağlayıcının talep sonrası adımları (alıcıyla iletişim, teklif ya da poliçe) talebin durumuna yansımaz.

Listeleme: GET /api/v1/insurance/leads

Taleplerinizi en yeniden eskiye, cursor tabanlı sayfalar hâlinde döner.

Yanıtta talepler data.items dizisindedir; sayfalama bilgisi pageInfo alanındadır. Bozuk bir cursor 422 insurance.validation.invalid (field: cursor) döner.

source lunixi-sign.sh
REQ_PATH="/api/v1/insurance/leads?limit=25&insuranceType=CARGO_TRANSIT"
lunixi_sign GET "$REQ_PATH"
 
curl "https://api-gateway.lunixi.com$REQ_PATH" \
  -H "X-Key-Id: $LUNIXI_KEY_ID" \
  -H "X-Date: $DATE" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE"

Okuma: GET /api/v1/insurance/leads/{leadId}

Tek bir talebi döner. Yanıtta data talep nesnesidir. Webhook alamadığınız bir sonucu doğrulamak için bu ucu kullanın.

Hatalar

Ortak kodlar: Akışlar › Yanıt ve hatalar. Kodların ayrıntısı: Hata Kodları › Talep.

İlgili

• Sigorta Tipleri ve Şemalar: talep şemaları
• Webhook Olayları: insurance.lead.submitted
• Hata Kodları: talebin kodları