Автокаталог

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

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

• Загрузите данные каталога единоразово и в дальнейшем периодически обновляйте их.
• Интегрируйте методы 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
       }
       ]
   }      
      

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

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

• По аналогии с получением информации о самом автомобиле продолжить использовать параметиризированные запросы для каждого свойства.
• Использовать метод, возвращающий все возможные модификации автомобиля в виде нескольких объектов.

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 – ее текстовым представлением.