GET /dealer/auction/current-state

Возвращает аукционы дилера.

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

GET https://apiauto.ru/1.0/dealer/auction/current-state

Заголовки запроса

Заголовок	Описание
`x-dealer-id`	Идентификатор клиента. Используется для работы под учетной записью агентства.
`x-session-id`	Идентификатор сессии пользователя. Значение можно получить с помощью операции POST /auth/login.

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

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

{
  "states": [
    {
      "context": {
        "mark_code": "{string}",
        "mark_ru": "{string}",
        "mark_name": "{string}",
        "model_code": "{string}",
        "model_ru": "{string}",
        "model_name": "{string}",
        "region_id": "{string}"
      },
      "base_price": "{string}",
      "current_bid": "{string}",
      "one_step": "{string}",
      "min_bid": "{string}",
      "competitive_bids": [
        {
          "bid": "{string}",
          "competitors": "{string}"
        }
      ],
      "range_steps": [
        {
          "bid_from": {
            "kopecks": "{string}"
          },
          "bid_to": {
            "kopecks": "{string}"
          },
          "step_price": "{string}"
        }
      ]
    }
  ]
}

states

Список настроек аукциона.

context

Контекст.

mark_code

Код марки автомобиля. Поле используется в запросах POST /dealer/auction/place-bid и POST /dealer/auction/leave.

mark_ru

Марка автомобиля на русском языке.

mark_name

Марка автомобиля.

model_code

Код модели автомобиля. Поле используется в запросах POST /dealer/auction/place-bid и POST /dealer/auction/leave.

model_ru

Модель автомобиля на русском языке.

model_name

Модель автомобиля.

region_id

Идентификатор региона пользователя.

base_price

Базовая цена продукта в копейках.

current_bid

Текущая ставка в копейках.

one_step

Стоимость одного шага аукциона в копейках.

min_bid

Минимальная ставка аукциона в копейках.

competitive_bids

Ставки конкурентов.

bid

Ставка в копейках.

competitors

Количество пользователей, сделавших ставку.

range_steps

Стоимость одного шага аукциона в копейках в соответствии с размером ставки.

bid_from

Размер ставки в копейках, начало диапазона, включительно.

bid_to

Размер ставки в копейках, конец диапазона, включительно. Если в ответе нет, значит ограничения сверху нет.

step_price

Стоимость одного шага аукциона в копейках.

Коды ответа

Код	Причина	Описание
200	OK	Успешный запрос.
401	NO_AUTH	Не удалось авторизовать пользователя по переданным данным.
403	CUSTOMER_ACCESS_FORBIDDEN	Доступ для данного пользователя запрещен.
500	INTERNAL SERVER ERROR	Внутренняя ошибка сервера.

Пример

Запрос:

curl -i -X GET
--header 'Accept: application/json'
--header 'x-session-id: 14090654|1622...' 
'https://apiauto.ru/1.0/dealer/auction/current-state'

Ответ:

{
 "states": [
     {
         "context": {
             "mark_code": "CADILLAC",
             "mark_ru": "Кадиллак",
             "mark_name": "Cadillac",
             "model_code": "SRX",
             "model_ru": "срх",
             "model_name": "srx",
             "region_id": "1"
         },
         "base_price": "450000",
         "one_step": "10000",
         "min_bid": "470000",
         "range_steps": [
             {
                 "bid_from": {
                     "kopecks": "0"
                 },
                 "step_price": "10000"
             }
         ]
     },
     {
         "context": {
             "mark_code": "CHERY",
             "mark_ru": "Чери",
             "mark_name": "Chery",
             "model_code": "BONUS",
             "model_ru": "Бонус",
             "model_name": "Bonus",
             "region_id": "1"
         },
         "base_price": "200000",
         "current_bid": "260000",
         "one_step": "10000",
         "min_bid": "220000",
         "competitive_bids": [
             {
                 "bid": "200400",
                 "competitors": "1"
             }
         ],
         "range_steps": [
             {
                 "bid_from": {
                     "kopecks": "0"
                 },
                 "bid_to": {
                     "kopecks": "1490000"
                 },
                 "step_price": "10000"
             },
             {
                 "bid_from": {
                     "kopecks": "1500000"
                 },
                 "step_price": "300000"
             }
         ]
     }
 ]
}

Была ли статья полезна?

POST /comeback

POST /dealer/auction/place-bid