Interfejs API danych wyceny

ClearVin wyceny API łączy historyczne zakupu i danych aukcji w czasie rzeczywistym, aby zapewnić pełny obraz wartości rynkowej danego pojazdu. Punkty danych obejmują szczytową i średnią wartość sprzedaży, wartość handlową i wartość aukcji.

Uwaga: Dane dotyczące wyceny rynkowej są dostępne tylko dla pojazdów w stanie produkcji i nie obejmują żadnych zmian na rynku wtórnym pojazdu ani zmian w stanie tytułu.

ZOBACZ DEMO

Autoryzacji

Aby uzyskać token dostępu przy użyciu tego adresu URL, musisz użyć adresu e-mail i hasła:

POST https://www.clearvin.com/rest/vendor/login

Żądanie musi pochodzić z zarejestrowanego adresu IP.
Ładowność powinna wynosić:

{
    "email" : “[email protected]”,
    "password": "11111111"
}

Odpowiedzi

Element	Opis	Formacie
status	określa, czy żądanie zostało rozpatrzone pomyślnie, czy zakończyło się błędem	Ciąg `error` lub `ok`
message	Zawiera szczegółowe informacje o wyniku, jeśli stan jest `error`	Ciąg
token	Token internetowy JSON. Token wygasa za 10 minut	Ciąg

Jeśli adres e-mail i hasło są poprawne token zostanie zwrócona odpowiedź z tokenem w następujący sposób:

{
    "status": "ok",
    "token": " I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0"
}

Raportu

Po otrzymaniu tego tokenu można go używać do uzyskiwania dostępu do raportów przy użyciu tego adresu URL:

GET https://www.clearvin.com/rest/vendor/report?vin=5UXFA13544LU21050

Aby użyć tego punktu końcowego, należy podać nagłówek HTTP z dostarczonym tokenem w następujący sposób:

Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0

Odpowiedzi

Element	Opis	Typu
status	określa, czy żądanie zostało rozpatrzone pomyślnie, czy zakończyło się błędem	Ciąg `error` lub `ok`
message	Zawiera szczegółowe informacje o wyniku, jeśli stan jest `error`	Ciąg
Report id	Zawiera identyfikator raportu bieżącego	Ciąg
Report vin	Żądany vin	Ciąg
Report report	Zawiera pełne informacje o pojeździe	Obiekt JSON

Możesz też otrzymywać raporty w widoku html, używając adresu URL w ten sposób:

GET https://www.clearvin.com/rest/vendor/report?vin=5UXFA13544LU21050&format=html

I podaj następne nagłówki HTTP:

Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0

Content-Type: text/html

Sukces Auth

Żądanie

curl -X POST \
    https://www.clearvin.com/rest/vendor/login \
    -H 'Content-Type: application/json' \
    -d '{
        "email": "[email protected]",
        "password": "yourpassword"
}

Sukces odpowiedzi

{
    "status": "ok",
    "token": "I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0"
}

Błąd odpowiedzi

{
    "status": "error",
    "message": "Wrong username or password"
}

Raportu

Żądanie

curl - X GET\ 'https://www.clearvin.com/rest/vendor/report?vin=WBAFR7C57CC811956'\ -
    H 'Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0'\ -
    H 'Content-Type: application/json'

Sukces odpowiedzi

{
  "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
    }
  }
}