InsureHub API'si, kendi yazılımlarınızı veya üçüncü parti uygulamaları InsureHub ile entegre etmenizi sağlar. RESTful mimari, JSON veri formatı ve Bearer token kimlik doğrulaması kullanır.

Kimlik Doğrulama

Tüm API isteklerinde HTTP başlığına API anahtarınızı ekleyin:

Authorization: Bearer {API_KEY}
Content-Type: application/json

API anahtarınızı Admin Paneli → Ayarlar → API Entegrasyonları bölümünden oluşturabilirsiniz.

Base URL

https://www.insurehub.com.tr/api/v1

Müşteriler

Method	Endpoint	Açıklama
`GET`	`/customers`	Müşteri listesi (sayfalı)
`GET`	`/customers/{id}`	Müşteri detayı
`POST`	`/customers`	Yeni müşteri oluştur
`PUT`	`/customers/{id}`	Müşteri güncelle
`DELETE`	`/customers/{id}`	Müşteri sil

Poliçeler

Method	Endpoint	Açıklama
`GET`	`/policies`	Poliçe listesi
`GET`	`/policies/{id}`	Poliçe detayı
`POST`	`/policies`	Yeni poliçe

Örnek İstek

curl -X GET "https://www.insurehub.com.tr/api/v1/customers?page=1&limit=20" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json"

Örnek Yanıt

{
  "status": "success",
  "data": {
    "items": [...],
    "total": 142,
    "page": 1,
    "per_page": 20
  }
}

Hata Kodları

Kod	Anlam
`200`	Başarılı
`400`	Geçersiz istek parametresi
`401`	Kimlik doğrulama hatası
`404`	Kaynak bulunamadı
`429`	Hız limiti aşıldı
`500`	Sunucu hatası

Hız Limitleri

API istekleri dakikada 60 sorgu ile sınırlıdır. Kurumsal planlar için özel limit artırımı talep edilebilir. Limit aşıldığında 429 Too Many Requests yanıtı döner.

Destek

API entegrasyonu için teknik destek: api@insurehub.com.tr

API Dokümantasyon