
2026. november 17.
Egy használtautó adatlapjának kézi összeállítása könnyen fél óra. A járműadatok API közvetlenül a kereskedői rendszerbe küldi az adatokat, így az elgépelt alvázszám nem jut tovább észrevétlenül a hirdetésbe vagy a számlába.
Egyetlen autóhoz elég lehet egy böngészőben lekért előéleti jelentés. Havi több tucat autónál viszont használtautó- és márkakereskedéseknek, importőröknek, illetve kereskedői szoftverek fejlesztőinek érdemes összekötniük az adatlekérést a napi munkával.
Röviden
- A rendszer VIN-t küld, és feldolgozható JSON-választ kap.
- A műszaki adatok, az értékbecslés és az előélet külön lekérdezések.
- A munkafolyamathoz szükséges lekérdezéseket érdemes kiválasztani.
- A hiányzó adat és a modellre vonatkozó egyezés külön figyelmet igényel.
Járműadatok API az autó kereskedésen belüli útján
Az autó beérkezik, árat kap, hirdetésbe kerül, végül átadják. Mindegyik állomáson más kérdésre kell válaszolni: melyik változat ez, mennyit ér, mit írhatunk róla, és érinti-e visszahívás?
Az API.VIN több mint húsz funkciót kínál. Nem szükséges minden autónál minden funkciót meghívni: a munkafolyamathoz illő adatokat érdemes kiválasztani.
1. Beérkezés: helyes VIN, pontos adatlap
Az adatlap kitöltése előtt célszerű az azonosítót ellenőrizni, majd a jármű adatait lekérni.
- Formai ellenőrzés: a
checkVinValidhibánál megadja a legvalószínűbb helyes VIN-t és legfeljebb három alternatívát. - Dekódolás: a
getVinDecodera gyártó által kódolt márkát, típust, hengerűrtartalmat, teljesítményt, sok autónál alap- és extrafelszereltséget adja vissza. - Azonosítók helye: a
getVinPlateLocationfelsorolja az alvázszám beütési, feltüntetési helyeit és a gyártói adattábla helyét.
A formai ellenőrzés felismeri a felcserélt karaktereket, az összetéveszthető 8/B, 0/D, 1/J, V/W párokat és az egyetlen hibás karaktert. Kiszűri az alvázszámban nem megengedett I, O és Q betűt is. Érdemes a további hívások elé tenni.
A VIN-dekódolás API európai, amerikai és ázsiai márkáknál használható, de részletessége járműfüggő. Az azonosítók helyénél külön jelzés mutatja, hogy az információt ennél az autónál rögzítették, vagy a modellre és évjáratra jellemző. Importautónál ez az eredetiségvizsgálat előtti keresést is segíti.
2. Árazás: futásteljesítmény és gyári rendeltetés
Az autó értékbecslés alvázszám alapján a futásteljesítménnyel együtt értelmezhető. A getVinValuation VIN-t, kilométeróra-állást és pénznemet vár; minimumot, átlagot, maximumot és mediánt ad vissza. Adatbázisa naponta frissül.
Például egy 2019-es, 115 000 km-t futott kompakt autót tervez meghirdetni a kereskedés. A tervezett hirdetési árat a mediánnal és a becsült sáv felső szélével összevetve felmérhető a hosszabb készleten állás kockázata. Az értékbecslés beszámításkor tárgyalási alap, készleten pedig az eltérően árazott autók kiszűrésében segít.
A getVinPurpose megmutatja a különleges gyári rendeltetést, például taxi, rendőrautó, oktatóautó vagy mentő, valamint az értékesítési csatornát: flotta, lízing, bérbeadás, állami vagy magánvásárló.
Ez gyári konfiguráció, nem teljes használati előélet. A későbbi átalakításokat nem mutatja meg.
3. Hirdetés: műszaki leírás, kezelhető alternatívákkal
A getVinCatalogSpec teljes katalógusleírást ad. A hirdetési mezőkbe többféle adat kerülhet:
- generáció, karosszéria, motorkód és üzemanyag;
- teljesítmény, nyomaték, váltó és hajtás;
- méretek, tömegek és vontatható tömeg;
- menetteljesítmények, fogyasztás, CO2 és környezetvédelmi besorolás.
Több illeszkedő katalógusváltozatnál a legvalószínűbb lesz a fő találat. A többi teljes alternatívaként érkezik, így nem kell pusztán egy listából kézzel kiválasztani a változatot. Az alternatívákat ugyanakkor érdemes láthatóan kezelni a kereskedői rendszerben.
4. Átadás: visszahívások és szervizkampányok
A visszahívás ellenőrzése alvázszám alapján a getVinRecalls funkcióval végezhető el. A válasz kampányszámot, dátumot, érintett alkatrészt, leírást és javítási módot tartalmaz.
Minden tételnél látszik az egyezés szintje: konkrétan a VIN érintett, vagy csak a modell és modellév alapján lehetséges az érintettség. A különbség értelmezéséhez hasznos háttér a járművisszahívások szerepéről szóló összefoglaló.
Az érintettség tisztázása után a kereskedés még átadás előtt elvégeztetheti az ingyenes visszahívásos javítást. Ha közeleg a műszaki vizsga, a két feladat egy szervizlátogatásra időzíthető.
Rövidített példaválasz a demóoldalról: a „match_level” mező mutatja, hogy a visszahívás a VIN-re vagy csak a modellre illeszkedik.
{
"vehicle": { "make": "Mitsubishi", "model": "Eclipse Cross" },
"recalls_total": 6,
"recalls": [
{
"campaign_number": "R/2021/334",
"date": "2021-11-15",
"component": "The front wheel moulding could become detached …",
"remedy": "An additional bracket will be installed …",
"match_level": "model"
}
]
}
Mely lekérdezések kellenek egy autóhoz?
A beszámított autó ellenőrzéséhez az alábbi hívások használhatók. A hirdetési katalógusleírás külön lekérdezéssel kérhető le.
| lépés | lekérdezés |
|---|---|
| alvázszám ellenőrzése | checkVinValid |
| dekódolás | getVinDecoder |
| adattábla és alvázszám helye | getVinPlateLocation |
| értékbecslés | getVinValuation |
| gyári rendeltetés | getVinPurpose |
| visszahívások | getVinRecalls |
Azokat a lekérdezéseket érdemes kiválasztani, amelyek adataira a munkafolyamatban ténylegesen szükség van.
Ha egy mező üresen marad
Nem minden VIN-hez érhető el minden adat. A rövidebb felszereltséglistát és a csak modellre illeszkedő visszahívást célszerű „egyeztetendő” jelöléssel megjeleníteni, majd az előző tulajdonossal vagy a vevővel tisztázni.
Hogyan kezdjen hozzá?
A bevezetést érdemes a mezők és a válaszok összevetésével kezdeni, nem az összes funkció bekötésével.
- Nézze meg a JSON-mintaválaszokat a demóoldalon.
- Az API.VIN oldalán tekintse át a felhasználási példákat: kereskedések, biztosítók, szervizek és hirdetési portálok feladatait.
- Kérjen tesztkulcsot a kapcsolatfelvételi űrlapon, az „Order the test API key” lehetőséggel.
- Tervezze meg a hiányzó adatok és az alternatív találatok megjelenítését.
Az oldal és a dokumentáció angol nyelvű. Nagy mennyiséghez kötegelt feldolgozás is elérhető; AI-asszisztensekkel dolgozó fejlesztőknek MCP-szerver áll rendelkezésre.
Gyakori kérdések
Milyen formátumban válaszol a járműadatok API?
A válaszok JSON-formátumúak. A kereskedői szoftver ezeket a megfelelő adatmezőkbe illesztheti.
Megmutatja a dekódolás az összes extrát?
Sok járműnél alap- és extrafelszereltség is elérhető. A részletesség azonban az adott autótól függ.
A gyári rendeltetésből látszik minden későbbi használat?
Nem. A getVinPurpose a gyári konfigurációt és az értékesítési csatornát írja le, a későbbi átalakításokat nem.



