API بيانات التقييم

يجمع كليرفين تقييم API بين الشراء التاريخية وبيانات المزاد في الوقت الحقيقي لتقديم صورة كاملة عن القيمة السوقية للسيارة معينة. نقاط البيانات تشمل ذروة ومتوسط قيمة البيع، والتجارة في القيمة، وقيمة المزاد.

يرجى ملاحظة: بيانات تقييم السوق متاحة فقط للمركبات في حالتها المصنعة ولا تتضمن أي تغييرات في ما بعد البيع على السيارة، أو تغييرات في حالة العنوان.

التخويل

ستحتاج إلى استخدام البريد الإلكتروني وكلمة المرور للحصول على رمز الوصول باستخدام عنوان URL هذا:
POST https://www.clearvin.com/rest/vendor/login
يجب أن يكون الطلب من عنوان IP مسجل.
يجب أن تكون الحمولة:
{
    "email" : “[email protected]”,
    "password": "11111111"
}
استجابه
عنصروصفتنسيق
statusتحديد ما إذا كان الطلب قد تمت معالجته بنجاح، أو أنهى بخطأسلسلة error أو ok
messageيحتوي على تفاصيل حول النتيجة إذا كانت الحالة errorسلسله
tokenJSON رمز الويب. تنتهي صلاحية الرمز المميز في غضون 10 دقائقسلسله


إذا كان البريد الإلكتروني وكلمة المرور صحيحة سيتم إرجاع الرمز المميز استجابة مع الرمز المميز كما يلي:
{
    "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": {
      "nada": {
        "modelYear": "2005",
        "make": "Audi",
        "model": "A6",
        "body": "Sedan 4D 3.2 AWD 3.2L V6",
        "averageMileage": "162500",
        "mileageAdjustment": "0",
        "adjustedCleanTrade": "2650",
        "adjustedAverageTrade": "1900",
        "adjustedRoughTrade": "1025",
        "adjustedCleanRetail": "4725",
        "adjustedLoan": "2400",
        "maxMileageAdj": "1325",
        "minMileageAdj": "-1060",
        "minAdjRetail": "420",
        "minAdjCleanTrade": "120",
        "minAdjAverageTrade": "120",
        "minAdjRoughTrade": "120",
        "minAdjLoan": "0",
        "fuelType": "Gas",
        "retail": "4725",
        "tradeIn": "2650",
        "roughTradeIn": "1025",
        "averageTradeIn": "1900",
        "loanValue": "2400",
        "uid": "200509150",
        "msrp": "40900",
        "tradeInValues": []
      },
      "previewImage": null
    }
  }
}