Rehberler
Kaza Rehberi API'sini kullanmaya başlamak için pratik rehberler — kimlik doğrulama, ilk çağrı ve uçtan uca örnek tazminat vakaları.
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ğını ve formülünü verir.
- 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_versiyonumantığı. - Yasal Dayanak — Trafik Genel Şartları, KTK/TBK maddeleri, TRH-2010.