Poliçe Kontrol API'si

Sigortan Tam'ın 18 poliçe kontrolünü kendi platformunda kullan. Poliçe bilgilerini gönder; puanı, eksik teminatları, düşük limitleri ve önerileri al.

Kimler için?

Teklif ve karşılaştırma siteleri, bankalar, araç ve emlak platformları, acente yazılımları, sohbet robotları.

Güncel kurallar

İMM eşikleri, Schengen teminatı gibi değerleri biz güncelleriz; senin entegrasyonun değişmez.

Veri saklanmaz

Gönderilen cevaplar yalnızca değerlendirme için kullanılır, kaydedilmez. Ad, TC kimlik ya da plaka gerekmez.

Başlarken

  1. /api/v1/urunler adresinden ürünleri, soruları ve her sorunun geçerli cevaplarını al.
  2. Kullanıcının poliçe bilgilerini bu sorulara göre topla. Bilinmeyen alanları gönderme ya da "bilmiyorum" gönder.
  3. POST /api/v1/kontrol/{urun} ile gönder; dönen maddeler listesini kullanıcıya göster.

Deneme anahtarı: stk_deneme_7f3a9c2e5b1d. Herkesle paylaşılan bu anahtarın günlük sınırı düşüktür; yalnızca deneme içindir. Kendi anahtarın için platformunun adını ve kullanım amacını sigortantam@gmail.com adresine yaz.

Uç noktalar

Yöntem ve adresAnahtarNe yapar?
GET /api/v1/urunlerGerekmezTüm ürünler, sorular, cevap türleri ve geçerli değerler
GET /api/v1/urunler/{urun}GerekmezTek ürünün soruları
POST /api/v1/kontrol/{urun}GerekirCevapları değerlendirir; puan ve maddeleri döner
POST /api/v1/portfoyGerekirİşletme profili ve poliçe listesinden portföy raporu: kapsam haritası, eksik zorunlu sigortalar, çakışmalar, bitiş takvimi
GET /api/v1/kullanimGerekirAnahtarının son 30 günlük çağrı sayıları

Ürün kodları: kasko, trafik, konut, dask, saglik, isyeri, ferdi, hayat, seyahat, isveren, ucuncu, karkaybi, nakliyat, makine, elektronik, urun, siber, mesleki.

Anahtarı Authorization: Bearer <anahtar> başlığıyla gönder. Anahtarı yalnızca sunucundan kullan; tarayıcıda ya da mobil uygulamanın içinde açıkta bırakma.

Cevap türleri

kosullu: true olan sorular yalnızca ilgili olduğunda sorulur (ör. İMM manevi tazminatı yalnızca İMM varsa). Göndermesen de olur.

Örnek istek

curl -X POST https://sigortantam.com/api/v1/kontrol/kasko \
  -H "Authorization: Bearer stk_deneme_7f3a9c2e5b1d" \
  -H "Content-Type: application/json" \
  -d '{"cevaplar":{"kapsam":"genis","servis":"anlasmali","muafiyet":"yok","imm":"dusuk","ikame":"yok","deprem":"var","sel":"bilmiyorum"}}'

Örnek yanıt (kısaltılmış)

{
  "urun": "kasko",
  "urun_adi": "Kasko",
  "puan": 55,
  "seviye": "orta",
  "yorum": "Kapatılması gereken boşluklar var.",
  "kritik_eksikler": [],
  "sayilar": {
    "eksik": 2,
    "uyari": 1,
    "bilinmiyor": 8,
    "tamam": 3
  },
  "maddeler": [
    {
      "alan": "imm",
      "baslik": "İhtiyari mali mesuliyet",
      "durum": "eksik",
      "kritik": false,
      "agirlik": 3,
      "mesaj": "İMM limitin düşük. Pahalı bir araca çarpmak ya da bedeni zarar, bu limiti kolayca aşabilir.",
      "oneri": "Sınırsız İMM'nin ek primi genellikle düşüktür; yenilemede sor."
    },
    {
      "alan": "ikame",
      "baslik": "İkame araç",
      "durum": "eksik",
      "kritik": false,
      "agirlik": 1,
      "mesaj": "İkame araç teminatın yok. Araç serviste kaldığı sürece ulaşım masrafı sana kalır.",
      "oneri": "İkame araç genellikle düşük ek primle eklenebilir."
    },
    …
  ],
  "kural_surumu": "2026-11-16",
  "uyari": "Sonuçlar gönderilen bilgilere dayanan genel bilgilendirmedir…"
}

Her yanıtta X-Gunluk-Limit ve X-Gunluk-Kalan başlıkları bulunur. Sayaç Türkiye saatiyle gece yarısı sıfırlanır.

İşletme portföyü

POST /api/v1/portfoy bir işletmenin bütün poliçelerini birlikte değerlendirir. Profil alanları ve geçerli değerleri portföy sayfasındaki sorularla aynıdır: sektor, hekim, calisan, lokasyon, mulk, konutBinasi, arac, tasima, musteri, stok, sevkiyat, makine, elektronik, urunRisk, hizmet, internet, tehlikeli. Poliçe türleri: trafik, kasko, koltuk, tasimaci, isyeri, dask, isveren, ucuncu, karKaybi, emtia, makine, elektronik, urun, mesleki, hekim, tehlikeli, siber, ferdi, saglik, diger. Ayrıntılı kontrolü olan türlerde cevaplar o ürünün sorularına göre gönderilir (ör. siber → /api/v1/urunler/siber).

curl -X POST https://sigortantam.com/api/v1/portfoy \
  -H "Authorization: Bearer stk_deneme_7f3a9c2e5b1d" \
  -H "Content-Type: application/json" \
  -d '{"profil":{"sektor":"yeme","calisan":8,"lokasyon":1,"mulk":"kira","konutBinasi":"evet","arac":1,"tasima":"yok","musteri":"evet","internet":"evet"},"policeler":[{"id":"a1","tur":"trafik","etiket":"Araç 1","bitis":"2027-03-01"},{"id":"i1","tur":"isyeri","bitis":"2027-01-15"}]}'

Hatalar

Hatalar { "hata": { "kod": "...", "mesaj": "..." } } biçiminde döner.

DurumKodAnlamı
400gecersiz_json, gecersiz_cevap, gecersiz_portfoyGövde JSON değil ya da bir cevap geçersiz; hatalar listesinde alan ve geçerli değerler yazar
401anahtar_yok, anahtar_gecersizAnahtar gönderilmemiş ya da yanlış
403anahtar_kapaliAnahtar kapatılmış
404urun_yokÜrün kodu yanlış
413cok_buyukGövde kontrolde 20 KB'tan, portföyde 200 KB'tan büyük
429limit_asildiGünlük çağrı sınırı doldu

Dene

Kullanım şartları