POST /dealer/auction/place-bid

Сделать ставку в аукционе.

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

POST https://apiauto.ru/1.0/dealer/auction/place-bid

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

Заголовок

Описание

x-dealer-id

Идентификатор клиента. Используется для работы под учетной записью агентства.

x-session-id

Идентификатор сессии пользователя. Значение можно получить с помощью операции POST /auth/login.

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

{
  "bid": {string},
  "previous_bid": {string},
  "context": {
    "mark_code": {string},
    "model_code": {string}
  }
}

bid

Новая ставка.


previous_bid

Предыдущая ставка.


context

Контекст.


mark_code

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


model_code

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


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

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

{
  "status": {string}
}

status

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

Коды ответа

Код

Причина

Описание

200

OK

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

401

NO_AUTH

Не удалось авторизовать пользователя по переданным данным.

403

AGENT_ACCESS_FORBIDDEN

Доступ для данного пользователя запрещен.

500

INTERNAL SERVER ERROR
UNKNOWN_ERROR

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

Пример

Запрос:

curl -X POST
--header 'x-session-id: 14090654|1622...' 
--header 'x-dealer-id: 16269' 
-d '{ \ 
 "bid": "470000", \ 
 "previous_bid": "460000", \ 
 "context": { \ 
   "mark_code": "CADILLAC", \ 
   "model_code": "SRX" \ 
   } \ 
 } \  
 }' 'https://apiauto.ru/1.0/dealer/auction/place-bid'

Ответ:


{
  "status": "SUCCESS"
}