Avito Evaluation API

openapi: 3.2.0
info:
  contact:
    email: supportautoload@avito.ru
  description: 'API для взаимодействия с иерархией аккаунтов в Авито

    **Авито API для бизнеса предоставляется согласно [Условиям использования](https://www.avito.ru/legal/pro_tools/public-api).**

    '
  title: Иерархия Аккаунтов Access Evaluation API
  version: '1'
servers:
- url: https://api.avito.ru/
tags:
- name: Evaluation
  x-displayName: Оценка и характеристики автомобиля
  x-subdivName: Оценка и характеристики автомобиля
paths:
  /autoteka/v1/catalogs/resolve:
    post:
      description: 'Метод для получения возможных параметров для заполнения пользователем.

        Первый запрос можно сделать без параметров, получить данные и далее, передавая нужные id и valueId в повторном запросе, получить все параметры.

        '
      operationId: catalogsResolve
      parameters:
      - $ref: '#/components/parameters/authHeader'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RequestCatalogsResolve'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogsResolveResponseBodyAutoteka'
          description: Успешный ответ
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/validatingError'
          description: Ошибка валидации входных параметров
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbiddenError'
          description: Операцию невозможно выполнить
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/notFoundError'
          description: Информация не найдена
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internalError'
          description: Информация об ошибке
      security:
      - ClientCredentials: []
      summary: 'Получение актуальных параметров Автокаталога

        '
      tags:
      - Evaluation
  /autoteka/v1/specifications/by-plate-number:
    x-gateway:
      timeouts:
        connect: 200ms
        envoy: 5.0s
        read: 5s
        send: 5s
    post:
      description: 'Метод для запроса на получение спецификации по регистрационному номеру, возвращает идентификатор спецификации, по которому можно получить спецификацию в [методе для получения спецификации](#operation/specificationGetById).


        Чтобы подключить эту возможность, обратитесь к менеджеру Автотеки. Обратите внимание, что для её подключения надо завести отдельную учётную запись Автотеки.

        '
      operationId: specificationByPlateNumber
      parameters:
      - $ref: '#/components/parameters/authHeader'
      requestBody:
        content:
          application/json:
            example:
              plateNumber: X793YX77
            schema:
              $ref: '#/components/schemas/RequestReportByPlateNumberAutoteka'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateSpecificationResponseBodyAutoteka'
          description: Успешный ответ
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/validatingError'
          description: Ошибка валидации входных параметров
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbiddenError'
          description: Операцию невозможно выполнить
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/notFoundError'
          description: Информация не найдена
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/tooManyRequestsError'
          description: Превышено допустимое количество запросов
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internalError'
          description: Информация об ошибке
      security:
      - ClientCredentials: []
      summary: 'Запрос характеристик по регистрационному номеру

        '
      tags:
      - Evaluation
  /autoteka/v1/specifications/by-vehicle-id:
    x-gateway:
      timeouts:
        connect: 200ms
        envoy: 5.0s
        read: 5s
        send: 5s
    post:
      description: 'Метод для запроса на получение спецификации по идентификатору авто (vin/frame), возвращает идентификатор спецификации, по которому можно получить спецификацию в [методе для получения спецификации](#operation/specificationGetById).


        Чтобы подключить эту возможность, обратитесь к менеджеру Автотеки. Обратите внимание, что для её подключения надо завести отдельную учётную запись Автотеки.

        '
      operationId: specificationByVehicleId
      parameters:
      - $ref: '#/components/parameters/authHeader'
      requestBody:
        content:
          application/json:
            example:
              vehicleId: XTA210990Y2766111
            schema:
              $ref: '#/components/schemas/RequestReportByVehicleIdAutoteka'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateSpecificationResponseBodyAutoteka'
          description: Успешный ответ
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/validatingError'
          description: Ошибка валидации входных параметров
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbiddenError'
          description: Операцию невозможно выполнить
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/notFoundError'
          description: Информация не найдена
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internalError'
          description: Информация об ошибке
      security:
      - ClientCredentials: []
      summary: 'Запрос характеристик по идентификатору авто (vin/frame)

        '
      tags:
      - Evaluation
  /autoteka/v1/specifications/specification/{specificationID}:
    parameters:
    - $ref: '#/components/parameters/authHeader'
    - description: Идентификатор спецификации
      in: path
      name: specificationID
      required: true
      schema:
        minimum: 1
        type: integer
    get:
      description: 'Метод для получения спецификации по ее идентификатору.


        Чтобы подключить эту возможность, обратитесь к менеджеру Автотеки. Обратите внимание, что для её подключения надо завести отдельную учётную запись Автотеки.

        '
      operationId: specificationGetById
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSpecificationResponseBodyAutoteka'
          description: Успешный ответ
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/validatingError'
          description: Ошибка валидации входных параметров
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbiddenError'
          description: Операцию невозможно выполнить
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/notFoundError'
          description: Информация не найдена
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internalError'
          description: Информация об ошибке
      security:
      - ClientCredentials: []
      summary: 'Получение характеристик по ID запроса

        '
      tags:
      - Evaluation
  /autoteka/v1/valuation/by-specification:
    x-gateway:
      timeouts:
        connect: 200ms
        envoy: 5.0s
        read: 5s
        send: 5s
    post:
      description: 'Метод для получения оценки по параметрам, полученным из методов [получения спецификации по ее идентификатору](#operation/specificationID) и [получения параметров автокаталога Авито](#operation/catalogsResolve)


        Чтобы подключить эту возможность, обратитесь к менеджеру Автотеки. Обратите внимание, что для её подключения надо завести отдельную учётную запись Автотеки.

        '
      operationId: valuationBySpecification
      parameters:
      - $ref: '#/components/parameters/authHeader'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RequestValuationBySpecificationResolve'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValuationBySpecificationResponseBodyAutoteka'
          description: Успешный ответ
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/validatingError'
          description: Ошибка валидации входных параметров
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbiddenError'
          description: Операцию невозможно выполнить
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/notFoundError'
          description: Информация не найдена
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/tooManyRequestsError'
          description: Превышено допустимое количество запросов
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internalError'
          description: Информация об ошибке
      security:
      - ClientCredentials: []
      summary: 'Получение оценки по параметрам

        '
      tags:
      - Evaluation
components:
  schemas:
    SpecificationEquipmentAutoteka:
      properties:
        bodyNumber:
          description: Номер кузова
          properties:
            title:
              description: Номер кузова
              example: Номер кузова
              type: string
            value:
              description: Строковое значение
              type: string
          required:
          - title
          - value
          type:
          - object
          - 'null'
        bodyType:
          description: Тип ТС
          properties:
            title:
              description: Заголовок
              example: Категория ТС
              type: string
            value:
              description: Текстовое значение
              enum:
              - Автобусы прочие
              - Грузовой бортовой
              - Грузовой прочий
              - Грузовой фургон
              - Грузовые автомобили бортовые
              - Грузовые автомобили фургоны
              - Легковое купе
              - Легковой прочий
              - Легковой седан
              - Легковой универсал
              - Легковой хэтчбек (комби)
              - Легковые автомобили кабриолет
              - Легковые автомобили комби (хэтчбек)
              - Легковые автомобили купе
              - Легковые автомобили прочие
              - Легковые автомобили седан
              - Легковые автомобили универсал
              - Мотоциклы
              type: string
          required:
          - title
          - value
          type:
          - object
          - 'null'
        brand:
          description: Бренд
          properties:
            title:
              description: Заголовок
              example: Бренд
              type: string
            value:
              description: Текстовое значение
              enum:
              - AUDI
              - BENTLEY
              - BMW
              - CADILLAC
              - CHERY
              - CHEVROLET
              - CHRYSLER
              - CITROEN
              - DACIA
              - DAEWOO
              - DAF
              - DATSUN
              - DODGE
              - FIAT
              - FORD
              - FREIGHTLINER
              - GAZ
              - GEELY
              - GENESIS
              - GREAT WALL
              - HONDA
              - HYUNDAI
              - Honda
              - INFINITI
              - ISUZU
              - IVECO
              - JEEP
              - Jaguar
              - KAMAZ
              - KIA
              - LADA
              - LEXUS
              - LIFAN
              - Land Rover
              - MAN
              - MAZ
              - MAZDA
              - MERCEDES
              - MERCEDES-BENZ
              - MINI
              - MITSUBISHI
              - NISSAN
              - OPEL
              - PEUGEOT
              - PORSCHE
              - RENAULT
              - ROVER
              - SEAZ
              - SKODA
              - SMART
              - SSANGYONG
              - SUBARU
              - Suzuki
              - TAGAZ
              - TOYOTA
              - UAZ
              - VAZ
              - VOLKSWAGEN
              - VOLVO
              - YAMAHA
              - ZAZ
              example: BMW
              type: string
          required:
          - title
          - value
          type:
          - object
          - 'null'
        color:
          description: Цвет кузова
          properties:
            description:
              description: Текстовое значение
              example: Синий
              type: string
            title:
              description: Заголовок
              example: Цвет
              type: string
            value:
              description: Текстовое значение
              enum:
              - Бежево-Серый
              - Бежевый
              - Белый
              - Белый Металлик
              - Белый Перламутр
              - Белый Черный
              - Белый-Желтый-Серый
              - Белый/Черный
              - Бордовый
              - Бронзовый
              - Вишнево-Красный
              - Жемчужно-Белый
              - Зеленый
              - Золотисто-Коричневый
              - Золотисто-Охристый
              - Коричневый
              - Красный
              - Мальва
              - Многоцветный (Красный, Чёрный)
              - Мурена (Тёмно-Синий)
              - Оранжево-Красный
              - Оранжево-Черный
              - Оранжевый
              - Оранжевый Перламутровый
              - Оранжевый Черный
              - Перлам-Серебристый
              - Перламутрово-Серебристый
              - Светло-Коричневый
              - Светло-Серый
              - Светло-Синий
              - Серебристо-Белый
              - Серебристый
              - Серо Зеленый
              - Серо-Зеленый
              - Серо-Золотистый
              - Серо-Коричневый
              - Серо-Сине-Зеленый Металлик
              - Серо-Синий
              - Серый
              - Сине-Черный
              - Синий
              - Синий Темный
              - Скат
              - Средний Серо-Зеленый
              - Стальной
              - Темно Серый
              - Темно-Бордовый
              - Темно-Вишневый
              - Темно-Голубой
              - Темно-Зеленый
              - Темно-Серый
              - Темно-Синий
              - Черно-Серый
              - Черный
              - Черный Металлик
              example: Синий
              type: string
          required:
          - description
          - title
          - value
          type:
          - object
          - 'null'
        engineNumber:
          description: Номер двигателя
          properties:
            title:
              description: Номер двигателя
              example: Номер двигателя
              type: string
            value:
              description: Строковое значение
              type: string
          required:
          - title
          - value
          type:
          - object
          - 'null'
        engineType:
          description: Тип двигателя
          properties:
            title:
              description: Заголовок
              example: Тип двигателя
              type: string
            value:
              description: Текстовое значение
              enum:
              - Бензин
              - Дизель
              - Электро
              - Газ
              - Гибрид
              - Бензиновый на сжиженном газе
              - Бензиновый на сжатом газе
              - Дизельный на сжиженном газе
              - Дизельный на сжатом газе
              - Электро-бензиновый
              - Электро-дизельный
              example: Бензиновый
              type: string
          required:
          - title
          - value
          type:
          - object
          - 'null'
        horsepower:
          description: Количество лошадиных сил
          properties:
            description:
              description: Текстовое значение
              example: 265 л.с.
              type: string
            title:
              description: Заголовок
              example: Мощность
              type: string
            value:
              description: Числовое значение
              example: 265
              format: int64
              type: integer
          required:
          - description
          - title
          - value
          type:
          - object
          - 'null'
        maxWeight:
          description: Разрешенная максимальная масса
          properties:
            description:
              description: Текстовое значение
              example: 1645 кг
              type: string
            title:
              description: Заголовок
              example: Разрешенная максимальная масса
              type: string
            value:
              description: Числовое значение
              example: 1645
              format: int64
              type: integer
          required:
          - title
          - value
          - description
          type:
          - object
          - 'null'
        model:
          description: Модель
          properties:
            title:
              description: Заголовок
              example: Модель
              type: string
            value:
              description: Текстовое значение
              example: Serie 1
              type: string
          required:
          - title
          - value
          type:
          - object
          - 'null'
        netWeight:
          description: Масса без нагрузки
          properties:
            description:
              description: Текстовое значение
              example: 1245 кг
              type: string
            title:
              description: Заголовок
              example: Масса без нагрузки
              type: string
            value:
              description: Числовое значение
              example: 1245
              format: int64
              type: integer
          required:
          - title
          - value
          - description
          type:
          - object
          - 'null'
        vehicleCategory:
          description: Категория ТС
          properties:
            title:
              description: Заголовок
              example: Категория ТС
              type: string
            value:
              description: Текстовое значение
              enum:
              - A
              - B
              - C
              - D
              - E
              - O
              - M1
              - M1G
              - N1
              example: D
              type: string
          required:
          - title
          - value
          type:
          - object
          - 'null'
        volume:
          description: Объем двигателя
          properties:
            description:
              description: Текстовое значение
              example: 2 996 см³
              type: string
            title:
              description: Заголовок
              example: Объем двигателя
              type: string
            value:
              description: Числовое значение
              example: 2996
              format: int64
              type: integer
          required:
          - description
          - title
          - value
          type:
          - object
          - 'null'
        year:
          description: Год выпуска
          properties:
            title:
              description: Заголовок
              example: Год выпуска
              type: string
            value:
              description: Числовое значение
              example: 2008
              format: int64
              type: integer
          required:
          - title
          - value
          type:
          - object
          - 'null'
      required:
      - bodyNumber
      - brand
      - color
      - engineNumber
      - engineType
      - horsepower
      - maxWeight
      - model
      - netWeight
      - vehicleCategory
      - bodyType
      - volume
      - year
      type:
      - object
      - 'null'
    SpecificationResultAutoteka:
      properties:
        equipment:
          $ref: '#/components/schemas/SpecificationEquipmentAutoteka'
        normalizedSpecification:
          $ref: '#/components/schemas/SpecificationNormalizedSpecificationAutoteka'
        plateNumber:
          description: Регистрационный номер
          example: X777XX777
          type:
          - string
          - 'null'
        specificationId:
          description: Идентификатор спецификации
          example: 157987
          format: int64
          type: integer
        status:
          description: Статус `success`, `processing`, `notFound`
          example: success
          type: string
        vehicleId:
          description: Идентификатор запрашиваемого авто (vin/frame)
          example: XUUNF487JA0007223
          type:
          - string
          - 'null'
      required:
      - equipment
      - normalizedSpecification
      - specificationId
      - plateNumber
      - status
      - vehicleId
      type: object
    internalError:
      properties:
        error:
          properties:
            code:
              description: Код ошибки
              example: 500
              format: int32
              type: integer
            message:
              description: Сообщение об ошибке
              example: Service is temporary unavailable
              type: string
          required:
          - code
          - message
          type: object
      type: object
    SpecificationNormalizedSpecificationAutoteka:
      properties:
        bodyType:
          description: Кузов
          properties:
            value:
              description: Значение
              example: Внедорожник
              type: string
            valueId:
              description: Идентификатор значения
              example: 331231
              format: int64
              type: integer
          required:
          - valueId
          - value
          type:
          - object
          - 'null'
        brand:
          description: Бренд
          properties:
            value:
              description: Значение
              example: Chery
              type: string
            valueId:
              description: Идентификатор значения
              example: 329210
              format: int64
              type: integer
          required:
          - valueId
          - value
          type:
          - object
          - 'null'
        capacity:
          description: Емкость
          properties:
            value:
              description: Значение
              example: 129
              format: float64
              type: number
          required:
          - value
          type:
          - object
          - 'null'
        complectation:
          description: Комплектация
          properties:
            value:
              description: Значение
              example: Comfort
              type: string
            valueId:
              description: Идентификатор значения
              example: 369961
              format: int64
              type: integer
          required:
          - valueId
          - value
          type:
          - object
          - 'null'
        doorsCount:
          description: Количество дверей
          properties:
            value:
              description: Значение
              example: 5
              format: int64
              type: integer
            valueId:
              description: Идентификатор значения
              example: 331245
              format: int64
              type: integer
          required:
          - valueId
          - value
          type:
          - object
          - 'null'
        drive:
          description: Привод
          properties:
            value:
              description: Значение
              example: Передний
              type: string
            valueId:
              description: Идентификатор значения
              example: 331251
              format: int64
              type: integer
          required:
          - valueId
          - value
          type:
          - object
          - 'null'
        engine:
          description: Объем двигателя
          properties:
            value:
              description: Значение
              example: 2.4
              format: float64
              type: number
            valueId:
              description: Идентификатор значения
              example: 331775
              format: int64
              type: integer
          required:
          - valueId
          - value
          type:
          - object
          - 'null'
        engineType:
          description: Тип двигателя
          properties:
            value:
              description: Значение
              example: Бензин
              type: string
            valueId:
              description: Идентификатор значения
              example: 331247
              format: int64
              type: integer
          required:
          - valueId
          - value
          type:
          - object
          - 'null'
        generation:
          description: Поколение
          properties:
            value:
              description: Значение
              example: T11 (2005—2013)
              type: string
            valueId:
              description: Идентификатор значения
              example: 332287
              format: int64
              type: integer
          required:
          - valueId
          - value
          type:
          - object
          - 'null'
        model:
          description: Модель
          properties:
            value:
              description: Значение
              example: Tiggo (T11)
              type: string
            valueId:
              description: Идентификатор значения
              example: 330887
              format: int64
              type: integer
          required:
          - valueId
          - value
          type:
          - object
 

# --- truncated at 32 KB (57 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/avito/refs/heads/main/openapi/avito-evaluation-api-openapi.yml