API de données d'évaluation
L'API d'évaluation ClearVin combine des données d'achat historiques et d'enchères en temps réel pour fournir une image complète de la valeur marchande d'un véhicule donné. Les points de données incluent la valeur de vente maximale et moyenne, la valeur d'échange et la valeur de l'enchère.
Remarque : les données d'évaluation du marché ne sont disponibles que pour les véhicules dans leur état de fabrication et n'incluent pas les modifications apportées au véhicule après-vente ou les modifications de l'état du titre.
Autorisation
Vous devrez utiliser une adresse e-mail et un mot de passe pour obtenir le jeton d'accès en utilisant cette URL :POST https://www.clearvin.com/rest/vendor/login
La demande doit provenir d'une adresse IP enregistrée.
La charge utile doit être :{ "email" : “[email protected]”, "password": "11111111" }
Réponse
ÉLÉMENT | LA DESCRIPTION | FORMAT |
---|---|---|
status | Indique si la demande a été traitée avec succès ou s'est terminée avec une erreur | error chaîne ou ok |
message | Contient des détails sur le résultat si le statut est error | Chaîne |
token | Jeton Web JSON. Le jeton expire dans 10 minutes | Chaîne |
Si l'e-mail et le mot de passe sont corrects, le jeton sera renvoyé en réponse avec le jeton comme suit :
{ "status": "ok", "token": " I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0" }
Rapport
Après avoir reçu ce jeton, vous pouvez l'utiliser pour accéder aux rapports à l'aide de cette URL :GET https://www.clearvin.com/rest/vendor/report?vin=5UXFA13544LU21050
Pour utiliser ce point de terminaison, vous devez fournir l'en-tête HTTP avec le jeton fourni comme suit :Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0
Réponse
ÉLÉMENT | LA DESCRIPTION | TYPE |
---|---|---|
status | Indique si la demande a été traitée avec succès ou s'est terminée avec une erreur | error chaîne ou ok |
message | Contient des détails sur le résultat si le statut est error | Chaîne |
Report id | Contient l'identifiant du rapport actuel | Chaîne |
Report vin | Niv demandé | Chaîne |
Report report | Contient des informations complètes sur le véhicule | Objet JSON |
Vous pouvez également recevoir des rapports en vue html en utilisant une URL comme celle-ci :
GET https://www.clearvin.com/rest/vendor/report?vin=5UXFA13544LU21050&format=html
Et fournissez les prochains en-têtes HTTP :
Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0
Content-Type: text/html
Succès de l'authentification
Demande
curl -X POST \ https://www.clearvin.com/rest/vendor/login \ -H 'Content-Type: application/json' \ -d '{ "email": "[email protected]", "password": "yourpassword" }
Succès de la réponse
{ "status": "ok", "token": "I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0" }
Erreur de réponse
{ "status": "error", "message": "Wrong username or password" }
Rapport
Demande
curl - X GET\ 'https://www.clearvin.com/rest/vendor/report?vin=WBAFR7C57CC811956'\ - H 'Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0'\ - H 'Content-Type: application/json'
Succès de la réponse
{ "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"] } } } }