Оценка текущей стоимости авто

Метод: GET

Endpoint: GET /api/v1/auto/grade

Параметры (query):

• modification — id модификации авто (не обязательно)

• type - id типа кузова авто (не обязательно)

• model - id модели авто (не обязательно)

• state - состояние авто (строка: Отличное, Хорошее, Удовлетворительное, Требует ремонта, На запчасти или цифра оценки от 1 до 5) (не обязательно, по умолчанию - Хорошее)

• owners - количество владельцев (число) (не обязательно, по умолчанию - 1)

• mileage - пробег в тыс. км (не обязательно, по умолчанию 20000)

• power - мощность двигателя в л.с. (не обязательно, по умолчанию 100 л.с.)

• engine - тип двигателя (строка: Бензин, Дизель, Электро или цифра от 1 до 3 (1-бензин, 3 - электро)) (не обязательно, по умолчанию - Бензин)

• year - год выпуска (не обязательно, по умолчанию последний год выпуска модификации или текущий)

Должен быть передан хотя бы один параметр из списка modification, type, model.

В случае передачи id типа кузова оценка ведется по конкретному кузову конкретной модификации.

В случае указания только id модификации оценка ведется по всем кузовам модификации

В случае указания только модели оценка ведется по всей модели без учета типа модификации, двигателя и т д.

Чем больше параметров передано, тем точнее оценка.

Дополнительный параметр

• test - любое значение (не обязательно)

С переданным параметром вернется отладочная информация оценок - диапазоны цен, коэффициенты корректировки и т д.

Примеры:

Запрос:

GET /api/v1/auto/grade?modification=190&test=1&owners=6&year=2008&state=%D0%A5%D0%BE%D1%80%D0%BE%D1%88%D0%B5%D0%B5&mileage=160000&power=120&engine=%D0%94%D0%B8%D0%B7%D0%B5%D0%BB%D1%8C 

Ответ:

{
    "base_price": 456095.04132231,
    "engine": 1.2,
    "engine_coef": 0.09501749525715,
    "grade": 470747,
    "mileage": 160000,
    "model_years": 11,
    "owners": 6,
    "owners_coef": 4.1159776897173,
    "power": 120,
    "price_from": 125000,
    "price_to": 500000,
    "quality_avr": 34090.909090909,
    "state": 4,
    "state_coef": 0.38629436111989,
    "year": 2008,
    "year_age": 2.125
}

Запрос:

GET /api/v1/auto/grade?modification=190&owners=6&year=2008&state=%D0%A5%D0%BE%D1%80%D0%BE%D1%88%D0%B5%D0%B5&mileage=160000&power=120&engine=%D0%94%D0%B8%D0%B7%D0%B5%D0%BB%D1%8C 

Ответ:

{
    "grade": 470747
}

Запрос:

GET /api/v1/auto/grade?type=19&test=1 

Ответ:

{
    "base_price": 1448500,
    "engine": 1,
    "engine_coef": 0,
    "grade": 1506058,
    "mileage": 0,
    "model_years": 10,
    "owners": 1,
    "owners_coef": 0,
    "power": 100,
    "price_from": 260000,
    "price_to": 1750000,
    "quality_avr": 149000,
    "state": 4,
    "state_coef": 0.38629436111989,
    "year": 2022,
    "year_age": 1
}

Запрос:

GET /api/v1/auto/grade?model=19&test=1 

Ответ:

{
    "base_price": 112211.253,
    "engine": 1,
    "engine_coef": 0,
    "grade": 126909,
    "mileage": 20000,
    "model_years": 10,
    "owners": 1,
    "owners_coef": 0,
    "power": 100,
    "price_from": 6299.98,
    "price_to": 133125,
    "quality_avr": 12682.502,
    "state": 4,
    "state_coef": 0.38629436111989,
    "year": 2022,
    "year_age": 3
}

Где:

• grade - оценка стоимости авто исходя из переданных параметров

• price_from - начальная вилка цены на рынке

• price_to - конечная вилка цены на рынке

• base_price - оценка исходя только из года выпуска

• model_years - количество лет выпуска модификации в случае, если не указана - средний срок жизни модели марки на рынке

• owners_coef - коэффициент, учитывающий количество владельцев в связи с продолжительностью эксплуатации

• quality_avr - расчетное снижение стоимости за год

• state_coef - коэффициент учета состояния автомобиля

• engine_coef - коэффициент учета налоговых платежей в зависимости от мощности двигателя