Genel Bakış
Oto Veri API, araçları Araç Tipi → Marka → Seri → Jenerasyon (yıl) → Donanım şeklinde kademeli bir hiyerarşide sunan salt-okunur (GET) bir REST API'dir. Tüm uç noktalar JSON döner ve şu an kimlik doğrulaması gerektirmez.
Canlı Seçim Paneli
Aşağıdaki panel, API'nin tüm uç noktalarını sırasıyla çağırarak Araç Tipi → Yıl → Marka → Model → Yakıt → Kasa Tipi → Vites → Alt Donanım seçimini adım adım yapar; bir sütunda seçim yapıldıkça bir sonraki sütun otomatik yüklenir.
Kademeli Akış
A) Klasik akış (Marka önce)
Her adımın döndürdüğü id veya slug, bir sonraki adımın URL'sinde kullanılır.
B) Yıl önce akışı
Bazı kullanım senaryolarında yıl, markadan önce seçilmek istenebilir. Bu akış, veritabanı şemasını değiştirmeden (Seri hâlâ bir Marka'ya bağlıdır) aynı veri üzerinde ters yönden sorgu yapar: bkz. Yıl Önce Akışı.
/vehicle-types
Kademeli seçimin ilk adımı: Otomobil / Arazi,SUV&Pickup / Ticari Araçlar / Motosiklet.
Örnek İstek
curl https://otodatasi.com/api/v1/vehicle-types
Örnek Yanıt
{
"data": [
{ "id": 1, "name": "Otomobil", "slug": "otomobil", "icon": null },
{ "id": 2, "name": "Arazi, SUV & Pickup", "slug": "arazi-suv-pickup", "icon": null }
]
}
/vehicle-types/{slug}/brands
Seçilen araç tipindeki markalar. (Tüm markaları listelemek için /brands?vehicle_type= de kullanılabilir.)
Dene
/brands/{slug}/series?vehicle_type=
Seçilen markanın serileri (Ford gibi birden fazla araç tipinde satılan markalarda vehicle_type filtresi önerilir).
Yıl Önce Akışı
Aynı veri, aynı şema — sadece marka yerine önce yıl seçilir. Aşağıdaki 3 uç nokta, klasik akıştaki 2. ve 3. adımların yerine geçer; 4. adımdan (jenerasyon) itibaren iki akış birleşir.
/vehicle-types/{slug}/years
Seçilen araç tipinde en az bir aracın üretildiği/satıldığı yıl aralığı (min_year/max_year). Frontend bu aralıkla bir yıl dropdown'ı kurar.
/vehicle-types/{slug}/years/{year}/brands
Seçilen araç tipinde VE seçilen yılı kapsayan en az bir jenerasyonu olan markalar.
/vehicle-types/{slug}/years/{year}/brands/{brand_slug}/series
Seçilen araç tipi + yıl + marka altında, o yılı kapsayan modeller (seriler). Devamı için: dönen serinin id'siyle /series/{id}/generations?year= çağrılır (klasik akışla aynı adım).
/series/{id}/generations?year=
Serinin jenerasyonları (kasa/yıl aralığı). ?year=2019 gibi bir yıl verilirse yalnızca o yılı kapsayan jenerasyon döner.
Kademeli Donanım Seçimi
Jenerasyon (yıl) seçildikten sonra önce Yakıt, sonra Kasa Tipi, sonra Vites sorulup her adımda yalnızca bir önceki seçime uyan seçenekler listelenir. Son adımda kalan donanımlar Donanımlar uç noktasından (aynı filtrelerle) çekilir.
/generations/{id}/facets/fuel-types
1. adım: bu jenerasyonda gerçekten kullanılan yakıt tipleri (Benzin, Dizel, LPG...).
/generations/{id}/facets/body-types?fuel_type=
2. adım: seçilen yakıt tipine göre bu jenerasyonda bulunan kasa tipleri (Sedan, Hatchback, SUV...). fuel_type boş bırakılırsa tüm kasa tipleri döner.
/generations/{id}/facets/transmission-types?fuel_type=&body_type=
3. adım: seçilen yakıt + kasa tipine göre vites tipleri (Manuel, Otomatik...). Bu adımdan sonra kalan seçenekler doğrudan /generations/{id}/trims?fuel_type=&body_type=&transmission_type= ile (alt donanım listesi) çekilir.
/generations/{id}/trims?fuel_type=&body_type=&transmission_type=
Bir jenerasyonun donanımları (yakıt, vites, motor gücü vb.). Kademeli seçimin (yukarıdaki Kademeli Donanım Seçimi) son adımı olarak fuel_type/body_type/transmission_type filtreleri de kabul eder.
Serbest Arama / Filtreleme
/trims?q=&fuel_type=&transmission_type=&body_type=&min_hp=&max_hp=&per_page=
/trims/{id}
Tek bir donanımın tüm teknik detayı (motor, tork, tüketim, 0-100, vb.) ve üst hiyerarşisi (jenerasyon/seri/marka) ile birlikte.
/lookups
Yakıt, vites, çekiş ve kasa tipi listelerinin tamamı — filtre/dropdown arayüzü kurarken tek çağrıda tüm referans verisini almak için.