API date evaluare
Api-ul de evaluare ClearVin combină datele istorice de achiziție și de licitație în timp real pentru a oferi o imagine completă a valorii de piață a unui anumit vehicul. Punctele de date includ valoarea maximă și medie de vânzare, comerțul cu valoare și valoarea licitației.
Vă rugăm să rețineți: Datele privind evaluarea pieței sunt disponibile numai pentru vehiculele din starea lor fabricată și nu includ modificări ale pieței pieselor de schimb ale vehiculului sau modificări ale statului de proprietate.
autorizație
Va trebui să utilizați e-mailul și parola pentru a obține simbolul de acces folosind acest URL:POST https://www.clearvin.com/rest/vendor/login
Solicitarea trebuie să fie de la o adresă IP înregistrată.Sarcina utilă ar trebui să fie:
{
"email" : “[email protected]”,
"password": "11111111"
}răspuns
| element | descriere | format |
|---|---|---|
| status | precizează dacă solicitarea a fost tratată cu succes sau s-a încheiat cu o eroare | Șir error sau ok |
| message | Conține detalii despre rezultat dacă starea este error | șir |
| token | Simbolul web JSON. Simbolul expiră în 10 minute | șir |
Dacă e-mailul și parola sunt corecte, tokenul va primi răspuns cu token după urmează:
{
"status": "ok",
"token": " I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0"
}Raport
După ce primiți acest simbol, îl puteți utiliza pentru a accesa rapoarte utilizând acest URL:GET https://www.clearvin.com/rest/vendor/report?vin=5UXFA13544LU21050
Pentru a utiliza acest punct final, trebuie să furnizați antetul HTTP cu simbolul furnizat după urmează:Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0
răspuns
| element | descriere | tip |
|---|---|---|
| status | precizează dacă solicitarea a fost tratată cu succes sau s-a încheiat cu o eroare | Șir error sau ok |
| message | Conține detalii despre rezultat dacă starea este error | șir |
| Report id | Conține ID-ul curent al raportului | șir |
| Report vin | Vin solicitat | șir |
| Report report | Conține informații complete despre vehicul | Obiect JSON |
De asemenea, puteți primi rapoarte în vizualizarea HTML utilizând URL-uri de acest fel:
GET https://www.clearvin.com/rest/vendor/report?vin=5UXFA13544LU21050&format=html
Și furnizați următoarele anteturi HTTP:
Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0
Content-Type: text/html
Auth succes
Cerere
curl -X POST \
https://www.clearvin.com/rest/vendor/login \
-H 'Content-Type: application/json' \
-d '{
"email": "[email protected]",
"password": "yourpassword"
}Răspuns de succes
{
"status": "ok",
"token": "I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0"
}Eroare de răspuns
{
"status": "error",
"message": "Wrong username or password"
}Raport
Cerere
curl - X GET\ 'https://www.clearvin.com/rest/vendor/report?vin=WBAFR7C57CC811956'\ -
H 'Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0'\ -
H 'Content-Type: application/json'Răspuns de succes
{
"status": "ok",
"result": {
"id": "00CA168F",
"vin": "WAUDG74F25N111998",
"report": {
"blackbook": {
"publish_date": "12/29/2023",
"data_freq": "D",
"state": "NT",
"country": "US",
"vin": "3FAHP0HAB",
"uvc": "2011300901",
"groupnum": "0023",
"model_year": "2011",
"make": "Ford",
"model": "Fusion",
"series": "SE",
"style": "4D Sedan",
"mileage_cat": "B",
"class_code": "C",
"class_name": "Mid-Size Car",
"description_score": "",
"first_values_flag": false,
"risk_score": "",
"base_whole_xclean": 3900,
"mileage_whole_xclean": 0,
"add_deduct_whole_xclean": 0,
"regional_whole_xclean": 0,
"adjusted_whole_xclean": 3900,
"mileage_whole_clean": 0,
"add_deduct_whole_clean": 0,
"regional_whole_clean": 0,
"adjusted_whole_clean": 2900,
"mileage_whole_avg": 0,
"add_deduct_whole_avg": 0,
"regional_whole_avg": 0,
"adjusted_whole_avg": 1550,
"mileage_whole_rough": 0,
"add_deduct_whole_rough": 0,
"regional_whole_rough": 0,
"adjusted_whole_rough": 350,
"base_retail_xclean": 7800,
"mileage_retail_xclean": 0,
"add_deduct_retail_xclean": 0,
"regional_retail_xclean": 0,
"adjusted_retail_xclean": 7800,
"base_retail_clean": 6550,
"mileage_retail_clean": 0,
"add_deduct_retail_clean": 0,
"regional_retail_clean": 0,
"adjusted_retail_clean": 6550,
"base_retail_avg": 4400,
"mileage_retail_avg": 0,
"add_deduct_retail_avg": 0,
"regional_retail_avg": 0,
"adjusted_retail_avg": 4400,
"base_retail_rough": 2500,
"mileage_retail_rough": 0,
"add_deduct_retail_rough": 0,
"regional_retail_rough": 0,
"adjusted_retail_rough": 2500,
"base_tradein_clean": 2980,
"mileage_tradein_clean": 0,
"add_deduct_tradein_clean": 0,
"regional_tradein_clean": 0,
"adjusted_tradein_clean": 2980,
"base_tradein_avg": 1630,
"mileage_tradein_avg": 0,
"add_deduct_tradein_avg": 0,
"regional_tradein_avg": 0,
"adjusted_tradein_avg": 1630,
"base_tradein_rough": 350,
"mileage_tradein_rough": 0,
"add_deduct_tradein_rough": 0,
"regional_tradein_rough": 0,
"adjusted_tradein_rough": 350,
"region2": 0,
"region3": 0,
"region4": 0,
"region5": 0,
"region6": 0,
"msrp": 21515,
"retail_equipped": 23585,
"price_includes": "AC AT",
"wheel_base": 107.4,
"tire_size": "225/50R17",
"gvw": 3285,
"seat_cap": "5",
"fuel_type": "Gas",
"fuel_cap": "17.5",
"fuel_delivery": "SMPI",
"hwy_mpg": "32",
"city_mpg": "22",
"engine_description": "2.5L I-4 SMPI DOHC",
"cylinders": "4",
"engine_displacement": "2.5L",
"base_hp": "175 @ 6000",
"taxable_hp": 19.6,
"torque": "172 @ 4500",
"oil_cap": "5.0",
"transmission": "A",
"drivetrain": "FWD",
"num_gears": "6",
"ext_doors": "4",
"airbags": "Personal Safety System; Side Curtain",
"basic_warranty": "3-year/36,000-mile, Limited",
"powertrain_warranty": "5-year/60,000-mile",
"road_assist_warranty": "5-year/60,000-mile",
"add_deduct_list": [{
"uoc": "87",
"name": "Aluminum Wheels",
"xclean": 100,
"clean": 100,
"avg": 100,
"rough": 100,
"auto": "N",
"resid12": 0,
"resid24": 0,
"resid30": 0,
"resid36": 0,
"resid42": 0,
"resid48": 0,
"resid60": 0,
"resid72": 0
}, {
"uoc": "12",
"name": "Power Moonroof",
"xclean": 150,
"clean": 150,
"avg": 150,
"rough": 150,
"auto": "N",
"resid12": 0,
"resid24": 0,
"resid30": 0,
"resid36": 0,
"resid42": 0,
"resid48": 0,
"resid60": 0,
"resid72": 0
}, {
"uoc": "16",
"name": "V6",
"xclean": 200,
"clean": 200,
"avg": 200,
"rough": 200,
"auto": "N",
"resid12": 0,
"resid24": 0,
"resid30": 0,
"resid36": 0,
"resid42": 0,
"resid48": 0,
"resid60": 0,
"resid72": 0
}, {
"uoc": "05",
"name": "w/o Auto Trans",
"xclean": -450,
"clean": -450,
"avg": -450,
"rough": -450,
"auto": "N",
"resid12": 0,
"resid24": 0,
"resid30": 0,
"resid36": 0,
"resid42": 0,
"resid48": 0,
"resid60": 0,
"resid72": 0
}],
"mileage_list": [{
"model_year": "2011",
"range_begin": 1,
"range_end": 8000,
"xclean": 1475,
"clean": 1550,
"avg": 1625,
"rough": 1625,
"finadv": 1500,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 8001,
"range_end": 20000,
"xclean": 1375,
"clean": 1475,
"avg": 1550,
"rough": 1625,
"finadv": 1425,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 20001,
"range_end": 32000,
"xclean": 1300,
"clean": 1375,
"avg": 1475,
"rough": 1550,
"finadv": 1350,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 32001,
"range_end": 44000,
"xclean": 1225,
"clean": 1300,
"avg": 1375,
"rough": 1475,
"finadv": 1275,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 44001,
"range_end": 56000,
"xclean": 1150,
"clean": 1225,
"avg": 1300,
"rough": 1375,
"finadv": 1175,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 56001,
"range_end": 68000,
"xclean": 1075,
"clean": 1150,
"avg": 1225,
"rough": 1300,
"finadv": 1100,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 68001,
"range_end": 80000,
"xclean": 950,
"clean": 1075,
"avg": 1150,
"rough": 1225,
"finadv": 1000,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 80001,
"range_end": 87000,
"xclean": 800,
"clean": 950,
"avg": 1075,
"rough": 1150,
"finadv": 875,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 87001,
"range_end": 94000,
"xclean": 675,
"clean": 800,
"avg": 950,
"rough": 1075,
"finadv": 750,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 94001,
"range_end": 101000,
"xclean": 550,
"clean": 675,
"avg": 800,
"rough": 950,
"finadv": 600,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 101001,
"range_end": 108000,
"xclean": 400,
"clean": 550,
"avg": 675,
"rough": 800,
"finadv": 475,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 108001,
"range_end": 115000,
"xclean": 350,
"clean": 400,
"avg": 550,
"rough": 675,
"finadv": 375,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 115001,
"range_end": 122000,
"xclean": 300,
"clean": 350,
"avg": 400,
"rough": 550,
"finadv": 325,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 122001,
"range_end": 125000,
"xclean": 250,
"clean": 300,
"avg": 350,
"rough": 400,
"finadv": 275,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 125001,
"range_end": 128000,
"xclean": 175,
"clean": 250,
"avg": 300,
"rough": 350,
"finadv": 200,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 128001,
"range_end": 131000,
"xclean": 125,
"clean": 175,
"avg": 250,
"rough": 300,
"finadv": 150,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 131001,
"range_end": 134000,
"xclean": 75,
"clean": 125,
"avg": 175,
"rough": 250,
"finadv": 100,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 134001,
"range_end": 137000,
"xclean": 0,
"clean": 75,
"avg": 125,
"rough": 175,
"finadv": 50,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 137001,
"range_end": 140000,
"xclean": -75,
"clean": 0,
"avg": 75,
"rough": 125,
"finadv": -50,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 140001,
"range_end": 143000,
"xclean": -125,
"clean": -75,
"avg": 0,
"rough": 75,
"finadv": -100,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 143001,
"range_end": 146000,
"xclean": -175,
"clean": -125,
"avg": -75,
"rough": 0,
"finadv": -150,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 146001,
"range_end": 149000,
"xclean": -250,
"clean": -175,
"avg": -125,
"rough": -75,
"finadv": -200,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 149001,
"range_end": 152000,
"xclean": -300,
"clean": -250,
"avg": -175,
"rough": -125,
"finadv": -275,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 152001,
"range_end": 155000,
"xclean": -350,
"clean": -300,
"avg": -250,
"rough": -175,
"finadv": -325,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 155001,
"range_end": 158000,
"xclean": -400,
"clean": -350,
"avg": -300,
"rough": -250,
"finadv": -375,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 158001,
"range_end": 161000,
"xclean": -550,
"clean": -400,
"avg": -350,
"rough": -300,
"finadv": -475,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 161001,
"range_end": 164000,
"xclean": -675,
"clean": -550,
"avg": -400,
"rough": -350,
"finadv": -600,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 164001,
"range_end": 171000,
"xclean": -800,
"clean": -675,
"avg": -550,
"rough": -400,
"finadv": -750,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 171001,
"range_end": 178000,
"xclean": -950,
"clean": -800,
"avg": -675,
"rough": -550,
"finadv": -875,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 178001,
"range_end": 185000,
"xclean": -1075,
"clean": -950,
"avg": -800,
"rough": -675,
"finadv": -1000,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 185001,
"range_end": 192000,
"xclean": -1200,
"clean": -1075,
"avg": -950,
"rough": -800,
"finadv": -1150,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 192001,
"range_end": 199000,
"xclean": -1350,
"clean": -1200,
"avg": -1075,
"rough": -950,
"finadv": -1275,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 199001,
"range_end": 206000,
"xclean": -1575,
"clean": -1350,
"avg": -1200,
"rough": -1075,
"finadv": -1450,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 206001,
"range_end": 213000,
"xclean": -1650,
"clean": -1575,
"avg": -1350,
"rough": -1200,
"finadv": -1600,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 213001,
"range_end": 225000,
"xclean": -1650,
"clean": -1650,
"avg": -1575,
"rough": -1350,
"finadv": -1650,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 225001,
"range_end": 237000,
"xclean": -1650,
"clean": -1650,
"avg": -1650,
"rough": -1575,
"finadv": -1650,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 237001,
"range_end": 249000,
"xclean": -1650,
"clean": -1650,
"avg": -1650,
"rough": -1650,
"finadv": -1650,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 249001,
"range_end": 261000,
"xclean": -1650,
"clean": -1650,
"avg": -1650,
"rough": -1650,
"finadv": -1650,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 261001,
"range_end": 273000,
"xclean": -1650,
"clean": -1650,
"avg": -1650,
"rough": -1650,
"finadv": -1650,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 273001,
"range_end": 999999,
"xclean": -1650,
"clean": -1650,
"avg": -1650,
"rough": -1650,
"finadv": -1650,
"mileage_cat": "B"
}],
"model_number_list": ["P0H"]
}
}
}
}