Changelog
Tüm API değişiklikleri burada izlenir. Semantic Versioning uygulanır.
v1.2.0 — 2026-10 (randevu API, ExperAra)
Endpoints (/api/v1/partner/booking/*, dış host: https://api.ekspertiz.app/experara)
GET /dealers— partner'a açık bayiler (adres, koordinat, foto, yetkili kişi)GET /packages[?dealerId]— aktif paketler + fiyatGET /dealers/{id}/availability?date=— 30 dk slot ızgarası (çalışma saatleri)POST /appointments— randevu aç (CONFIRMED,externalRefile idempotent)PUT /appointments/{id}— tarih/saat güncelle (aynı id)DELETE /appointments/{id}— iptal (idempotent)GET /appointments?from&to&page&pageSize— yalnız partner'ın kendi randevuları- Dokümantasyon:
endpoints/booking-experara.md
Kimlik doğrulama
- Yeni anahtar şeması
authScheme=BEARER:Authorization: Bearer <keyId>.<secret>veya Basic. İmza/nonce/timestamp yok; yalnız TLS + IP allowlist + dar scope ile verilir. HMAC anahtarlar değişmedi (varsayılan). - Yeni scope'lar:
catalog:read,appointments:read,appointments:write. - Yeni hata kodları:
past_date(400),appointment_not_modifiable(409).
Şema
Appointment.source(INTERNAL/PUBLIC_FORM/PARTNER),partnerId,externalRef,packageIdBranch.contactPerson,ApiKey.authScheme
v1.0.0 — 2026-05
İlk yayın.
Endpoints
GET /api/v1/partner/healthGET /api/v1/partner/organizationsGET /api/v1/partner/organizations/{orgId}/branchesGET /api/v1/partner/inspections(cursor pagination, filtreler)GET /api/v1/partner/inspections/{id}GET /api/v1/partner/inspections/{id}/formsGET /api/v1/partner/inspections/{id}/photos(15dk presigned URL)GET /api/v1/partner/inspections/{id}/pdf
Güvenlik
- HMAC-SHA256 imzalı request'ler (timestamp + nonce + IP allowlist)
- AES-256-GCM ile secret storage
- KVKK uyumlu PII anonimizasyonu (NONE/MASKED/FULL modları)
- Multi-tenant izolasyon: 404 (403 değil) ID enumeration koruması
- 60 req/dk default rate limit
- Forensic için
ApiRequestLog(90 gün retention)
Notlar
- Sandbox:
https://sandbox-api.ekspertiz.app(tmk_test_…keyler) - Production:
https://api.ekspertiz.app(tmk_live_…keyler)
v1.1.0 — 2026-06
- Yeni:
POST /api/v1/partner/test-line/measurements— test hattı cihazı ölçüm gönderimi (Mates vb. üreticiler). Bayi kodu (branch_code) → firma + bayi çözümleme (partner erişim kapsamıyla sınırlı), plaka ile açık rapora otomatik işleme, eşleşme yoksa bekleme havuzu + eksper ekranında tek tık uygulama. Yeni scope:test-line:write. Detay: 09 · Test hattı cihaz entegrasyonu