Описать лот

PUT/v1/lots/{id}/description

Задаёт строку, которую маркет показывает под вашим лотом, до 32 символов. Пустая убирает описание. Это простой текст, без ссылок.

Запрос

Параметры пути

idstringобязательно
Id лота.

Тело запроса

descriptionstringобязательно
Новое описание. Пустое убирает его.

curl -X PUT 'https://api.rockvel.store/v1/lots/019a4b9d-2e17-7a58-b1c6-0d3f6a9e4b12/description' \
  -H "Authorization: Bearer $ROCKVEL_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"description":"Crown in the best spot"}'

Ответ 200

Пустой объект.

{}

Отказы

Статус	Код	Когда
409	`lot_gone`	Лот продан или снят.
422	`bad_description`	Описание длиннее 32 символов, в нём несколько строк или пробелы по краям.

Любой маршрут может также ответить статусами со страницы Ошибки.