Platitun · API · Карточки товара · Пометить карточку тестовой

Пометить карточку тестовой

POST /api/v1/listings/{number}/test

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

Тестовую карточку купит только тестовый покупатель, а обычный не купит вовсе. Обратно, из тестовой в настоящую, карточка переводится только если у продавца закрыт порог: иначе на витрину вышел бы товар продавца без документов.

Поля запроса

Поле	Тип	Что это
`isTest` обязательно	`boolean`	true — сделать тестовой, false — вернуть настоящей.

Поля ответа

Поле	Тип	Что это
`isTest`	`boolean`	Состояние после действия.

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

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

Код	Что случилось и что делать
`not_found`	Записи нет или она не ваша. Условие владения стоит в самом запросе к базе, поэтому чужая запись выглядит как отсутствующая.
`test_to_real_needs_papers`	Сделать тестовую карточку настоящей можно, только когда у вас закрыт порог продавца: иначе на витрину вышел бы товар продавца без документов.
`bad_request`	Запрос собран неверно: не хватает обязательного поля или значение не того вида. Подробность — в поле detail.

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

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 — Копия карточки
PUT /api/v1/listings/{number}/image — Картинка карточки
DELETE /api/v1/listings/{number}/image — Убрать картинку
GET /api/v1/questions — Вопросы по своим карточкам
POST /api/v1/questions/{id}/answer — Ответить на вопрос