Platitun · API · Карточки товара · Картинка карточки

Картинка карточки

PUT /api/v1/listings/{number}/image

Область ключа: listings · изменяет данные, нужен заголовок Idempotency-Key

Тело запроса — САМИ БАЙТЫ картинки, а не JSON: так это делает и форма кабинета. Вид файла определяется по содержимому, а не по названию и не по заголовку: заголовку тут верить нельзя.

Поля запроса

Поле	Тип	Что это
`(тело)` обязательно	`binary`	Байты картинки. Допустимы обычные изображения; предел размера тот же, что в кабинете.

Поля ответа

Поле	Тип	Что это
`image`	`string`	Имя сохранённого файла.

Поводы отказа

Отказ по правилам приходит как {"error":"rejected","refusal":{"kind":"…"}} с кодом 409. Общие для всех путей отказы — в разделе правил.

Код	Что случилось и что делать
`not_found`	Записи нет или она не ваша. Условие владения стоит в самом запросе к базе, поэтому чужая запись выглядит как отсутствующая.
`image_too_big`	Картинка больше допустимого размера. Уменьшите её и пришлите снова.
`image_bad_type`	Это не картинка допустимого вида. Вид определяется по содержимому файла, а не по названию: переименование не поможет.

Рядом в этом разделе

GET /api/v1/listings — Свои карточки
POST /api/v1/listings — Завести карточку
GET /api/v1/listings/{number} — Одна своя карточка
PATCH /api/v1/listings/{number} — Правка карточки
DELETE /api/v1/listings/{number} — Убрать карточку
POST /api/v1/listings/{number}/state — Включить, выключить, автовыдача
POST /api/v1/listings/{number}/copy — Копия карточки
POST /api/v1/listings/{number}/test — Пометить карточку тестовой
DELETE /api/v1/listings/{number}/image — Убрать картинку
GET /api/v1/questions — Вопросы по своим карточкам
POST /api/v1/questions/{id}/answer — Ответить на вопрос