Bu sayfa, kendi yazılımını (örneğin acentenizin CRM'i veya iç sistemleri) InsureHub'a bağlamak isteyen geliştiriciler içindir. Acente panelini ve mobil uygulamayı kullanmak için API'ye ihtiyacınız yoktur.

Teklif işlemleri InsureHub'ın geliştirdiği web servisleri üzerinden yürütülür. Acentelerin sigorta şirketlerinden API bilgisi temin etmesi gerekmez; InsureHub API'si yalnızca sizin yazılımınız ile InsureHub arasındaki bağlantıyı sağlar.

API anahtarı

Acente panelinde Acente → API ekranını açın.
Yeni anahtar bölümüne anahtar adını yazıp Oluştur'a tıklayın.
Anahtar (ih_live_ ile başlar) yalnızca bir kez gösterilir; güvenli bir yerde saklayın.

Bir acente için en fazla 10 aktif anahtar tanımlanabilir; kullanılmayan anahtarı İptal et ile geçersiz kılın. Anahtar, acentenizin aktif sigorta şirketi bağlantılarıyla teklif sorgulamaya yetki verir; ödeme veya poliçe düzenleme yetkisi vermez.

Kimlik doğrulama

X-Api-Key: ih_live_xxxxxxxxxxxxxxxx
# veya
Authorization: Bearer ih_live_xxxxxxxxxxxxxxxx

Uç noktalar

Yöntem	Adres	Açıklama
GET	`https://api.insurehub.com.tr/api/auth.php`	Anahtarın bağlı olduğu kullanıcı ve acente bilgisini döndürür.
POST	`https://api.insurehub.com.tr/api/quotes.php`	Teklif sorgusu başlatır; yanıt `application/x-ndjson` akışıdır.

Teklif isteği

İstek gövdesi JSON'dur. product: trafik, kasko, dask veya tss. Alanlar values nesnesinde gönderilir.

Alan	Zorunluluk	Açıklama
`values.tckn` / `values.vergiNo`	Zorunlu	Gerçek kişide TC kimlik no, tüzel kişide vergi no (`kisitip`: `gercek` \| `tuzel`).
`values.dogum`	Gerçek kişide önerilir	Doğum tarihi (GG.AA.YYYY).
`values.plaka`	Trafik/Kasko zorunlu	Araç plakası, örn. `34ABC123`.
`values.belgeseri`	Trafik/Kasko önerilir	Ruhsat belge seri no; araç bilgisi EGM'den tamamlanır.
`values.aracCinsi`	Trafik/Kasko zorunlu	Kullanım türü (örn. `otomobil`).
`values.sure`	İsteğe bağlı	`yillik` (varsayılan) veya kısa dönem; kısa dönemde `kisaSureGun`.
`values.telefon`	TSS ve yeni DASK'ta zorunlu	Cep telefonu, `5XXXXXXXXX` biçiminde.
`provider_keys`	İsteğe bağlı	Yalnızca belirli şirketlerden teklif almak için şirket anahtarları dizisi.

curl -N https://api.insurehub.com.tr/api/quotes.php \
  -H "X-Api-Key: ih_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"product":"trafik","values":{"kisitip":"gercek","tckn":"11111111111","dogum":"01.01.1990","plaka":"34ABC123","belgeseri":"AB123456","aracCinsi":"otomobil"}}'

Örnek NDJSON yanıtı

Her satır ayrı bir JSON nesnesidir. Önce vehicle (DASK/TSS'de risk) satırı, ardından şirket başına quote satırları gelir; uzun sorgularda bağlantıyı açık tutmak için ping satırları gönderilebilir. Aşağıdaki değerler örnektir.

{"type":"vehicle","quoteId":1001,"source":"egm","error":null,"vehicle":{"plate":"34 ABC123","make":"ÖRNEK MARKA","type":"ÖRNEK MODEL","modelYear":"2020"},"term":"yillik","startDate":"2026-10-14","endDate":"2027-10-14"}
{"type":"quote","key":"ornek","name":"Örnek Sigorta","ok":true,"product":"trafik","premium":"12500.00","installments":null,"proposalNo":"T-000001","status":"quoted","error":null,"elapsed":8.4}
{"type":"ping","pending":["ornek2"]}
{"type":"quote","key":"ornek2","name":"Örnek 2 Sigorta","ok":false,"premium":null,"status":"network","error":"Zaman aşımı — şirket sistemi yanıt vermedi","elapsed":60}

Hata yanıtları

Akış başlamadan oluşan hatalar tek bir JSON nesnesiyle döner:

Durum	Örnek gövde
401	`{"error":"Oturum gerekli"}` — anahtar yok veya geçersiz.
405	`{"error":"POST gerekli"}`
422	`{"error":"TC kimlik numarası gerekli"}`, `{"error":"Plaka gerekli"}`, `{"error":"Kullanım türü seçilmeli"}`
402	Paketinizin aylık sorgu limiti dolduğunda limit açıklaması.
200	`{"status":"vehicle_required","error":"EGM kaydı bulunamadı; marka/tip seçimi gerekiyor"}` — `marka`/`tip` veya `aracKodu` ile tekrar gönderin.
200	`{"status":"no_credentials"}` — acentenizde bu ürün için aktif sigorta şirketi tanımı yok.

Şirket bazlı hatalar akış içinde "ok":false ve status alanıyla gelir (örn. network, pending, not_integrated).

Teknik destek

Entegrasyon testleri için bilgi@insurehub.com.tr adresine acente adınız ve bağlamak istediğiniz yazılımla birlikte yazın. Gerçek müşteri verisiyle test yapmadan önce örnek kayıtlarla deneyin.

API Dokümantasyon