ClearVin API - تقدير القيمة السوقية بواسطة VIN
توفر واجهة برمجة التطبيقات إمكانية الوصول إلى البيانات الحالية حول القيمة السوقية للمركبة، بما في ذلك قيم البيع بالتجزئة والمقايضة والودائع، مما يساعد في تحديد السعر الفعلي المقبول للمركبة. يتم احتساب جميع الأسعار مع الأخذ بعين الاعتبار عدد الكيلومترات المقطوعة وتاريخ السيارة.
يرجى ملاحظة: بيانات تقييم السوق لا تتضمن أي تغييرات في السيارة بعد البيع. يتم إرجاع القيم الوطنية بشكل افتراضي، لكننا نقدم معلمات إضافية لاستخراج البيانات الخاصة بولاية معينة.
التخويل
ستحتاج إلى استخدام البريد الإلكتروني وكلمة المرور للحصول على رمز الوصول باستخدام عنوان URL هذا:POST https://www.clearvin.com/rest/vendor/login
يجب أن يكون الطلب من عنوان IP مسجل.يجب أن تكون الحمولة:
{
"email" : “[email protected]”,
"password": "11111111"
}استجابه
| عنصر | وصف | تنسيق |
|---|---|---|
| status | تحديد ما إذا كان الطلب قد تمت معالجته بنجاح، أو أنهى بخطأ | سلسلة error أو ok |
| message | يحتوي على تفاصيل حول النتيجة إذا كانت الحالة error | سلسله |
| token | JSON رمز الويب. تنتهي صلاحية الرمز المميز في غضون 120 دقائق | سلسله |
إذا كان البريد الإلكتروني وكلمة المرور صحيحة سيتم إرجاع الرمز المميز استجابة مع الرمز المميز كما يلي:
{
"status": "ok",
"token": " I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0"
}تقرير
بعد تلقي هذا الرمز المميز يمكنك استخدامه للوصول إلى التقارير باستخدام عنوان URL هذا:GET https://www.clearvin.com/rest/vendor/report?vin=5UXFA13544LU21050
لاستخدام نقطة النهاية هذه، تحتاج إلى توفير رأس HTTP مع الرمز المميز الذي تم توفيره كما يلي:Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0
استجابه
| عنصر | وصف | اكتب |
|---|---|---|
| status | تحديد ما إذا كان الطلب قد تمت معالجته بنجاح، أو أنهى بخطأ | سلسلة error أو ok |
| message | يحتوي على تفاصيل حول النتيجة إذا كانت الحالة error | سلسله |
| Report id | يحتوي على معرف التقرير الحالي | سلسله |
| Report vin | طلب فين | سلسله |
| Report report | يحتوي على معلومات كاملة عن السيارة | كائن JSON |
يمكنك أيضاً تلقي التقارير في طريقة عرض HTML باستخدام عنوان URL مثل هذا:
GET https://www.clearvin.com/rest/vendor/report?vin=5UXFA13544LU21050&format=html
وتوفير رؤوس HTTP التالية:
Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0
Content-Type: text/html
نجاح الويث
طلب
curl -X POST \
https://www.clearvin.com/rest/vendor/login \
-H 'Content-Type: application/json' \
-d '{
"email": "[email protected]",
"password": "yourpassword"
}نجاح الاستجابة
{
"status": "ok",
"token": "I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0"
}خطأ في الاستجابة
{
"status": "error",
"message": "Wrong username or password"
}تقرير
طلب
curl - X GET\ 'https://www.clearvin.com/rest/vendor/report?vin=WBAFR7C57CC811956'\ -
H 'Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0'\ -
H 'Content-Type: application/json'نجاح الاستجابة
{
"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"]
}
}
}
}