Platitun · API · Карточки услуг · Включить или выключить показ

Включить или выключить показ

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

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

Показ карточки на витрине. Включение делает цену публичной офертой: по ней продавец обязан продать.

🔴 Переключатель автовыдачи убран 13.09.2026: механизм удалён с площадки целиком вместе со складом. Все услуги оказывает продавец лично. Поле autoIssue в запросе и в ответе больше не существует, отказы auto_disabled и auto_needs_stock не приходят.

Поля запроса

Поле	Тип	Что это
`active`	`boolean`	На витрину или снять.

Поля ответа

Поле	Тип	Что это
`number`	`integer`	Публичный номер.
`isActive`	`boolean`	Состояние показа после действия.

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

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

Код	Что случилось и что делать
`not_found`	Записи нет или она не ваша. Условие владения стоит в самом запросе к базе, поэтому чужая запись выглядит как отсутствующая.
`bad_request`	Запрос собран неверно: не хватает обязательного поля или значение не того вида. Подробность — в поле detail.
`self_employed_forbidden`	Этот вид услуги недоступен статусу продавца. Самозанятому доступны ВСЕ виды услуг площадки: предметом сделки является услуга, которую продавец оказывает по заказу покупателя, а не перепродажа товара или имущественного права.
`self_employed_giftcode`	Самозанятому выдача промокодом недоступна: подарочный код, купленный заранее, — это передача имущественного права (п. 1.3 оферты продавца). Выберите другой способ выдачи. Тот же отказ приходит при правке, копии и включении карточки с промокодом, заведённой до смены статуса.

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

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}/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 — Ответить на вопрос