GET /dealer/auction/offer/{offer_id}/current_state
Возвращает состояние аукциона по объявлению.
Формат запроса
GET https://apiauto.ru/1.0/dealer/auction/offer/{offer_id}/current-state
|
offer_id |
Идентификатор объявления. |
Заголовки запроса
|
Заголовок |
Описание |
|
|
Идентификатор клиента. Используется для работы под учетной записью агентства. |
|
|
Идентификатор сессии пользователя. Значение можно получить с помощью операции POST /auth/login. |
Общая структура ответа приведена ниже. Порядок следования элементов не гарантируется. В структуре могут присутствовать служебные параметры, которые не описаны в таблице.
Формат ответа
{
"state": {
"current_bid": {integer},
"base_price": {integer},
"min_bid": {integer},
"max_bid": {integer},
"one_step": {integer},
"limit_exceeded": {boolean}
},
"segments": [
{
"percent": {integer},
"min_bid": {integer},
"max_bid": {integer},
"current": {boolean}
}
]
}
|
state |
Список настроек аукциона. |
-
current_bid
Текущая ставка в копейках.
base_price
Базовая цена продукта в копейках.
min_bid
Минимальная ставка аукциона в копейках.
max_bid
Максимальная ставка аукциона в копейках.
one_step
Стоимость одного шага аукциона в копейках.
limit_exceeded
Превышен лимит.
|
segments |
Описание сегментов. Примечание В выдаче будут показаны 5 сегментов |
-
percent
Процент интереса.
min_bid
Минимальная ставка аукциона в копейках для попадания в выбранный процент интереса.
max_bid
Максимальная ставка аукциона в копейках для попадания в выбранный процент интереса.
current
Объявление находится в этом сегменте интереса.
Коды ответа
|
Код |
Причина |
Описание |
|
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/offer/{offer_id}/current-state'Ответ:
{ "state": { "current_bid": 100000, "base_price": 100, "min_bid": 10000, "max_bid": 1290000, "one_step": 10000, "limit_exceeded": false }, "segments": [ { "percent": 5, "min_bid": 100, "max_bid": 50000, "current": true } ] }
Идентификатор объявления.