Rehberler

Bu bölüm, Kaza Rehberi API’sini uygulamaya geçirmek için pratik, uçtan uca rehberler içerir. Hesaplama Metodolojisi bölümü matematiğin nedenini; buradaki rehberler ise API’yi nasıl çağıracağınızı anlatır — gerçek istek/yanıt örnekleriyle.

Rehberler

Hızlı Başlangıç Sıfırdan ilk hesaplama yanıtına: OTP ile kimlik doğrulama, token alma, araç kataloğu arama ve ilk API çağrısı. curl ve JavaScript (fetch) örnekleriyle, hata yönetimi dahil.

Örnek Senaryolar Dört tazminat türünün adım adım sayısal vaka çalışması: değer kaybı, geçici iş göremezlik, araç mahrumiyeti ve manevi tazminat. Her adımın rakamıyla.

Hangi rehberle başlamalıyım?

API'yi ilk kez kullanıyorum

Hızlı Başlangıç ile başlayın — kimlik doğrulama ve ilk çağrının tüm adımlarını sırayla verir.

Bir hesabın nasıl çıktığını görmek istiyorum

Örnek Senaryolar — girdiden nihai tutara kadar her ara adımı rakamıyla gösterir.

Formülün kendisini merak ediyorum

Hesaplama Metodolojisi — her kalemin yasal dayanağı ve formülü.

Tam uç/şema listesi lazım

API Referansı ve canlı Swagger UI (/v1/docs).

Hızlı referans

Rehberlere dalmadan önce elinizin altında bulunması iyi olan temel bilgiler:

Konu	Değer
Base URL (prod)	`https://api.kazarehberi.com.tr`
Sürüm öneki	Tüm iş uçları `/v1` altındadır (ör. `/v1/hesaplamalar/deger-kaybi`)
İçerik tipi	`application/json`
Kimlik	Girişli uçlarda `Authorization: Bearer <accessToken>`
Kimlik doğrulama	Telefon + OTP (WhatsApp/SMS) → `accessToken` (15 dk) + `refreshToken` (30 gün)
Hata gövdesi	`{ "hata": { "kod": "...", "mesaj": "..." } }`
Ortak yanıt alanları	`toplam`, `kalemler[]`, `parametre_versiyonu`, `uyari`

İlgili bölümler

API Referansı Mimari, kimlik doğrulama, hata formatı ve uç katalogu.

Hesaplama Metodolojisi Her tazminat kaleminin formülü ve yasal dayanağı.

Güncel & Sürüm Yürürlükteki parametreler ve parametre_versiyonu mantığı.

Yasal Dayanak Trafik Genel Şartları, KTK/TBK maddeleri, TRH-2010.