P7: Araç Veritabanı API

Versiyon: 1.0.0 · Durum: Onaylandı — production altyapı

Merkezi araç ve ECU katalog veritabanının HTTP API yüzeyidir. Endpoint: api.ecutuningportal.com. Tüm portal ve satış hatlarının ortak veri omurgasıdır.

Kapsam

Tüketiciler

Tüketici	Kullanım
P3: ETP B2B Platform	Trial tenant, satış sitesi cascade
P5: Pemm PHP Portal	Self-host müşteri API lock-in
P6: TunerStack Ekosistemi	Portal araç seçimi
P2: Müşteri Landing Fabrikası	Pro şablon tuning simulator (Vehicle API)
Kendi marka / ETP klonları	Prisma veya API fallback

Kapsam dışı

• Portal iş mantığı (kredi, dosya upload, ödeme)
• Landing içerik yönetimi (P4 Hub)
• Veritabanının müşteri kaynak koduna gömülmesi (yasak)

Teknik model

Alan	Değer
Base URL	https://api.ecutuningportal.com
Auth	API key / tenant token (tüketiciye göre)
Veri kapsamı	66K+ araç kaydı; tip → marka → model → nesil → motor cascade
Araç tipleri	Otomobil, motosiklet, tekne, traktör, kamyon
Güncelleme	Merkezi YGT Labs operasyonu; tüketiciler read-heavy

Tipik cascade akışı

GET /types
    → GET /brands?type=car
        → GET /models?brand=BMW
            → GET /generations?model=3 Series
                → GET /engines?generation=F30

Pro şablon (reprocar simulator) ve portal upload wizard aynı cascade sözleşmesini kullanır. OpenAPI dokümantasyonu BL-004 kapsamında genişletilir.

Entegrasyon kuralları

1. Araç verisi yalnızca API üzerinden — kaynak koda gömme yasak
2. Rate limit ve cache header’ları tüketici başına izole
3. API kesintisinde portal graceful degrade (cached subset); satış durmaz
4. Yeni portal ürünleri P7’ye bağlanır; paralel veri silosu açılmaz

İş modeli

Gelir bağlantısı	Mekanizma
Pemm kaynak satış	Tek seferlik kod + recurring API abonelik
ETP SaaS	Platform lisansına dahil veya tier bazlı
TunerStack	Portal paketine dahil API kotası
Simulator (Pro landing)	Müşteri sitesi API key ile tüketir

API lock-in bilinçli stratejidir: kaynak kodu müşteride olsa bile veri ve güncelleme YGT Labs’ta kalır.

Operasyon

Konu	Uygulama
Uptime	Portal satış hattına kritik bağımlılık
Versiyonlama	Breaking change → tüketici bildirim + deprecation window
Monitoring	API latency, error rate, key usage
Backup	Merkezi PG/MySQL cluster; tüketici DB’lerinden ayrı

İlgili okuma

• P5: Pemm PHP Portal § API lock-in
• Product Documentation v5.4 § Vehicle Database
• Mimari Backlog BL-004 (OpenAPI)