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
- /api/v1/urunler adresinden ürünleri, soruları ve her sorunun geçerli cevaplarını al.
- Kullanıcının poliçe bilgilerini bu sorulara göre topla. Bilinmeyen alanları gönderme ya da
"bilmiyorum"gönder. POST /api/v1/kontrol/{urun}ile gönder; dönenmaddelerlistesini 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 adres | Anahtar | Ne yapar? |
|---|---|---|
GET /api/v1/urunler | Gerekmez | Tüm ürünler, sorular, cevap türleri ve geçerli değerler |
GET /api/v1/urunler/{urun} | Gerekmez | Tek ürünün soruları |
POST /api/v1/kontrol/{urun} | Gerekir | Cevapları değerlendirir; puan ve maddeleri döner |
POST /api/v1/portfoy | Gerekir | İşletme profili ve poliçe listesinden portföy raporu: kapsam haritası, eksik zorunlu sigortalar, çakışmalar, bitiş takvimi |
GET /api/v1/kullanim | Gerekir | Anahtarı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
- secenek:
seceneklerlistesindekidegerlerden biri (ör."var","yok","bilmiyorum"). - sayi: TL cinsinden pozitif sayı (ör.
2500000). - tarih:
YYYY-AA-GG(ör."2027-03-01").
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…"
}
- puan: 0–100. Cevapların çoğu bilinmiyorsa
nullveseviye: "yetersiz_bilgi". - seviye:
iyi(80+),orta(55–79),zayif(55 altı),yetersiz_bilgi. - maddeler[].durum:
eksik,uyari,bilinmiyor,tamam; bu sırayla gelir.kritik: trueolan bir eksik varsa puan en fazla 40 olur. - uyari: Son kullanıcıya gösterilmesi gereken bilgilendirme cümlesi.
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"}]}'
- kapsam[]: İşletmenin olması gereken her sigorta;
seviyezorunlu(yanında mevzuatdayanakı),onerilen,durumaya daek;durumeksik,uyariya datamam. - police_kontrolleri:
cevaplargönderilen her poliçenin, tek ürün kontrolüyle aynı biçimdeki sonucu (poliçeid'sine göre). - cakismalar aynı tür ve aynı
etiketiçin birden fazla geçerli poliçeyi, takvim 365 gün içinde bitenleri gösterir.etikete plaka ya da adres yerine kendi iç kodunu (ör."Araç 1") yazabilirsin. - Bir çağrıda en fazla 100 poliçe gönderilebilir; bir portföy çağrısı günlük sınırdan 1 düşer.
Hatalar
Hatalar { "hata": { "kod": "...", "mesaj": "..." } } biçiminde döner.
| Durum | Kod | Anlamı |
|---|---|---|
| 400 | gecersiz_json, gecersiz_cevap, gecersiz_portfoy | Gövde JSON değil ya da bir cevap geçersiz; hatalar listesinde alan ve geçerli değerler yazar |
| 401 | anahtar_yok, anahtar_gecersiz | Anahtar gönderilmemiş ya da yanlış |
| 403 | anahtar_kapali | Anahtar kapatılmış |
| 404 | urun_yok | Ürün kodu yanlış |
| 413 | cok_buyuk | Gövde kontrolde 20 KB'tan, portföyde 200 KB'tan büyük |
| 429 | limit_asildi | Günlük çağrı sınırı doldu |
Dene
Kullanım şartları
- Sonuçlar bilgilendirme amaçlıdır; poliçenin bağlayıcı hükümlerinin yerine geçmez.
uyarimetnini kullanıcıya göstermelisin. - Kullanıcıya gösterdiğin sonucun yanında "Poliçe kontrolü: Sigortan Tam" ibaresine yer vermelisin.
- API'ye ad, TC kimlik numarası, plaka, poliçe numarası gibi kişisel veri gönderme; sorular bunları gerektirmez.
- Kurallar zamanla güncellenir;
kural_surumudeğişebilir. Yanıttaki alan adları v1 boyunca korunur.