DEVekspertiz.app

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 + fiyat
  • GET /dealers/{id}/availability?date= — 30 dk slot ızgarası (çalışma saatleri)
  • POST /appointments — randevu aç (CONFIRMED, externalRef ile 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, packageId
  • Branch.contactPerson, ApiKey.authScheme

v1.0.0 — 2026-05

İlk yayın.

Endpoints

  • GET /api/v1/partner/health
  • GET /api/v1/partner/organizations
  • GET /api/v1/partner/organizations/{orgId}/branches
  • GET /api/v1/partner/inspections (cursor pagination, filtreler)
  • GET /api/v1/partner/inspections/{id}
  • GET /api/v1/partner/inspections/{id}/forms
  • GET /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