Platitun · API · Карточки товара · Убрать карточку

Убрать карточку

DELETE /api/v1/listings/{number}

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

Удаление возможно, только пока по карточке не было ни одного заказа: заказ обязан остаться самодостаточным для спора через месяц. Карточка с историей ВЫКЛЮЧАЕТСЯ, и ответ говорит об этом прямо.

Смотрите именно поле result, а не код ответа: 200 приходит в обоих случаях, и «удалил» без проверки поля — это ложь себе.

Поля ответа

Поле	Тип	Что это
`result`	`string`	«deleted» — удалена; «hidden» — выключена, потому что по ней были заказы.

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

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

Код	Что случилось и что делать
`not_found`	Записи нет или она не ваша. Условие владения стоит в самом запросе к базе, поэтому чужая запись выглядит как отсутствующая.
`has_questions`	По карточке были заказы или вопросы — удалить её нельзя, она выключается. Смотрите поле result.

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

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