Получение данных оценок
Чтобы получить информацию по конкретной оценке, выполните метод GET /cars/appraisals/find-last-by-car. Он возвращает информацию о результатах оценки по одному из идентификаторов, VIN или номеру кузова (критериев поиска):
- идентификатор оценки автомобиля в Авто.ру Бизнес;
- идентификатор оценки автомобиля в DMS;
- идентификатор автомобиля на складе в DMS;
- VIN-код автомобиля;
- номер кузова автомобиля.
При вызове метода нужно указать один или несколько критериев поиска. При указании нескольких критериев, метод будет осуществлять последовательный поиск по каждому отдельному критерию поиска в порядке, указанном выше. Метод вернет результаты первой найденной оценки.
При поиске может быть найдено несколько оценок. В этом случае метод вернет результаты оценки, имеющей максимальную дату создания.
При необходимости, можно получить через API список оценок при помощи метода GET /cars/appraisals. Метод позволяет выполнить необходимую фильтрацию и сортировку.
Пример запроса на получение оценок, сделанных за промежуток c 2022-05-01 00:00:00 включительно до 2022-05-10 00:00:00 времени и отсортированных по дате создания createdAt, новые в начале:
/cars/appraisals?page=1&perPage=10&filter[createdAt][gte]=2018-05-01 00:00:00&filter[createdAt][lt]=2018-05-10 00:00:00&sort=-createdAt
Список доступных фильтров:
idinspectionIdinspectionStatusdealerIdvinbodyNumberregistrationPlateNumberdmsAppraisalIdstatusIdcreatedAtupdatedAtchangedAtscoringmdsDayscontractTypebuyoutPriceadditionalCostsexpensesPercentmarkupmarkupPercentsellingPricesellingPricePercentsalePeriodattentionPercentcurrentImpressionPerDaycommentsaverageMileageaveragePriceaveragePriceAdjustedgroigroiCategorycustomerFirstNamecustomerLastNamecustomerPhonecustomerExpectedBuyoutPricecmeCarIdinChannelvehicleStateisByPhoneoriginalPtsownersAmountstandardAutoCheckIdavtocodAutoCheckIdautotekaAutoCheckId