POST /stats/predict_by_vin_or_lp

Возвращает информацию об автомобиле, которая найдена по VIN или ГРЗ.

Формат запроса

POST https://apiauto.ru/1.0/stats/predict_by_vin_or_lp

Формат тела запроса

{
  "car_identifier":{string},
  "km_age":{integer},
  "rid":{integer},
  "seller_type":{enum}  
}

car_identifier

VIN или ГРЗ автомобиля.

km_age

Пробег автомобиля, в км.

Примечание

Если пробег 0 км, то оценить автомобиль не получится.

rid

Массив идентификаторов регионов. Справочник регионов можно скачать по ссылке.

Ограничение

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

seller_type

Тип продавца.

Допустимые значения:
  • PRIVATE — частное лицо;
  • COMMERCIAL — салон.

Общая структура ответа приведена ниже. Порядок следования элементов не гарантируется. В структуре могут присутствовать служебные параметры, которые не описаны в таблице.

Формат ответа

{
    "autoru":{
      "from":{integer},
      "to":{integer},
      "currency":"{string}"
    },
    "tradein":{
      "from":{integer},
      "to":{integer},
      "currency":"{string}"
    },
    "buyout":{
      "from":{integer},
      "to":{integer},
      "currency":"{string}"
    },
    "found_info":{
      "tech_param_id":"{integer}",
      "color":"{string}",
      "owners_count":"{integer}",
      "year":"{integer}",
      "pts_original":"{boolean}",
      "steering_wheel": "{array}",
      "complectation_id":"{integer}",
      "marks":"{string}",
      "model":"{string}",
      "super_gen_id":"{integer}",
      "configuration_id":"{integer}",
      "photos":{
        "{string}":"{string}",
        "{string}":"{string}",
        "{string}":"{string}",
      }  
    }
  },
  "status":"{string}"
}

autoru

Стоимость на Авто.ру.

from

Стоимость, от.

to

Стоимость, до.

currency

Валюта.

tradein

Стоимость по «traid-in».

from

Стоимость, от.

to

Стоимость, до.

currency

Валюта.

buyout

Стоимость выкупа.

from

Стоимость, от.

to

Стоимость, до.

currency

Валюта.

found_info

Найденная информация.

tech_param_id

Идентификатор набора технических характеристик ТС. Список наборов технических характеристик с идентификаторами можно получить с помощью операции GET /search/cars/breadcrumbs.

color

Цвет транспортного средства в HEX-формате. Список допустимых значений смотрите в Справочнике цветов.

owners_count

Количество владельцев.

year

Год выпуска ТС.

pts_original*

Признак наличия оригинала ПТС.

Допустимые значения:
  • true — оригинал ПТС в наличии;
  • false — оригинал ПТС отсутствует.

steering_wheel

Расположение руля.

Допустимые значения:
  • LEFT — левый руль;
  • RIGHT — правый руль.

complectation_id

Идентификатор комплектации. Список идентификаторов можно получить с помощью операции GET /reference/catalog/cars/complectations

mark

Марка.

model

Модель.

super_gen_id

Идентификатор поколения.

configuration_id

Идентификатор конфигурации. Список конфигураций с идентификаторами можно получить с помощью операции GET /search/cars/breadcrumbs.

photos

Объект с возможными размерами фотографии. Пример: "mobile":"//images.md../943h4345/68..cd..ceeb..regbbdf43/mobile", где первый параметр — размер картинки, второй — URL-адрес картинки.

status

Статус ответа.

* Обязятальный параметр

Коды ответа

Код

Причина

Описание

200

OK

Успешный запрос.

Примечание

Такой ответ может быть получен, даже если найденной информации недостаточно, чтобы оценить авто.

202

IN_PROGRESS

VIN не был найден по заданному ГРЗ, и поиск продолжается. Нужно повторить запрос позже.

400

BAD_REQUEST

Ошибка в запросе: неверный VIN или ГРЗ.

404

NOT_FOUND

Не найдена информация по VIN или ГРЗ для этого автомобиля, или не найден VIN по ГРЗ.

500

INTERNAL SERVER ERROR

Внутренняя ошибка сервера.

Пример

Запрос:

curl -i -X POST 'https://apiauto.ru/1.0/stats/predict' -H 'x-authorization: 2dtrer432...' -d '{"rid":213,"tech_param_id":9383468,"km_age":50000,"color":"FAFBFB","owners_count":2,"year":2012,"pts_original":true,"steering_wheel":"LEFT","complectation_id":0,"seller_type":"PRIVATE"}' -H 'Accept: application/json' -H 'Content-Type:application/json'

Ответ:

HTTP/1.1 200 OK
Server: nginx
Date: Mon, 15 Nov 2022 18:01:38 GMT
Content-Type: application/json
Content-Length: 140
Connection: keep-alive

{
    "autoru": {
      "from": 1849000,
      "to": 1921000,
      "currency": "RUR"
    },
    "tradein": {
      "from": 1732000,
      "to": 1796000,
      "currency": "RUR"
    },
    "buyout": {
      "from": 1700000,
      "to": 1983000,
      "currency": "RUR"
    },
    "found_info": {
      "tech_param_id": 20435560,
      "color": "660099",
      "owners_count": 2,
      "year": 2016,
      "pts_original": true,
      "steering_wheel": "LEFT",
      "complectation_id": 20435695
      "mark": "MAZDA",
      "model": "6",
      "super_gen_id": 20435551,
      "configuration_id": 20435559,
      "photos": {
        "main": "//avatars.mds.yandex.net/get-verba/1540742/2a00000169a124f718248b2837ddafd08985/auto_main"
      }
    },
  },
  "status": "SUCCESS"
}

* Обязательный параметр

Предыдущая
POST /stats/predict
Следующая
POST /auth/login