Автокаталог

Использование данных автокаталога

Для использования данных автокаталога Авто.ру Бизнес используйте один из двух способов:

  • Загрузите данные каталога единоразово и в дальнейшем периодически обновляйте их.
  • Интегрируйте методы Appraisal.API в сервис и запрашивайте информацию по API по мере необходимости, не сохраняя на своей стороне данные каталога.

Примечание

Получение всех данных автокаталога одним запросом/файлом невозможно.

Методы работы с автокаталогом

Для получения информации по автомобилю необходимо последовательно использовать несколько методов, из которых все, кроме первого, являются параметризированными, и результат их выполнения зависит от выбранных параметров.

Входные параметры всегда имеют тип integer, и их значения должны соответствовать значениям автокаталога Авто.ру Бизнес.

Пример

Для получения значений параметров автомобиля автомобиля Opel Insignia / 1 поколение / 2012 год выпуска выполните последовательно ряд запросов.

Шаг 1. Получить список марок

Запрос:

curl -X GET "https://appraisal.api.cm.expert/v1/autocatalog/brands" -H "accept: application/json" -H "Authorization: Bearer <token>"

Ответ:


           {
               "brands": [
               {
               "id": 114,
               "text": "Opel"
               }
               ]
           }

Шаг 2. Получить все доступные модели для выбранной марки

Запрос:

curl -X GET "https://appraisal.api.cm.expert/v1/autocatalog/models?brand=114" -H "accept: application/json" -H "Authorization: Bearer <token>"

Ответ:


           {
               "models": [
               {
               "id": 114,
               "text": "Insignia"
               }
               ]
           }

Шаг 3. Получить все доступные года выпуска для этой модели этой марки

Запрос:

curl -X GET "https://appraisal.api.cm.expert/v1/autocatalog/creationYears?brand=114&model=1125" -H "accept: application/json" -H "Authorization: Bearer <token>"

Ответ:


           {
               "years": [
               2020,
               2019,
               2018,
               2017,
               2016,
               2015,
               2014,
               2013,
               2012,
               2011,
               2010,
               2009,
               2008
               ]
           }

Шаг 4. Получить все доступные поколения для этой модели этой марки этого года выпуска

Запрос:

curl -X GET "https://appraisal.api.cm.expert/v1/autocatalog/generations?brand=114&model=1125&creationYear=2012" -H "accept: application/json" -H "Authorization: Bearer <token>"

Ответ:


           {
               "generations": [
               {
               "id": 2685,
               "text": "1 поколение",
               "from": 2008,
               "to": 2013
               }
               ]
           }

Примечание

Шаг 3 можно пропустить, если год выпуска автомобиля точно известен. Но если на шаге 4 передать год, который не соответствует марке и модели – то вернется пустой ответ.

Получение модификации автомобиля

Для получения модификации автомобиля автомобиля используйте один из двух способов:

  • По аналогии с получением информации о самом автомобиле продолжить использовать параметиризированные запросы для каждого свойства.
  • Использовать метод, возвращающий все возможные модификации автомобиля в виде нескольких объектов.
curl -X GET "https://appraisal.api.cm.expert/v1/autocatalog/modifications?brand=114&model=1125&creationYear=2012&generation=2685" -H "accept: application/json" -H "Authorization: Bearer <token>"

Для примера выше одна из модификаций будет выглядеть так:


        {
            "id": 20396399,
            "text": "2.0d AT (190 л.с.) 4WD",
            "brand": {
                "id": 114,
                "text": "Opel"
            },
            "model": {
                "id": 1125,
                "text": "Insignia"
            },
            "years": {
                "from": 2012,
                "to": 2013
            },
            "generation": {
                "id": 2685,
                "text": "I"
            },
            "body": {
                "id": 21,
                "text": "Хетчбэк"
            },
            "doors": 5,
            "gear": {
                "id": 1,
                "text": "Автомат"
            },
            "drive": {
                "id": 5,
                "text": "Полный"
            },
            "engine": {
                "id": 2,
                "text": "Дизель"
            },
            "volume": 2.0,
            "power": 190,
            "wheel": {
                "id": 1,
                "text": "Левый"
            }
        }

Значение поля id является идентификатором модификации автомобиля, а text – ее текстовым представлением.

Предыдущая
Обращение к методам API
Следующая
Получение списка регионов