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

Правка карточки

PATCH /api/v1/listings/{number}

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

Присылается ЦЕЛИКОМ, всеми полями. Правила карточки связаны между собой — способ выдачи зависит от вида товара, курс и объём от типа «токены», — и одно поле в отрыве от остальных проверить не против чего. Сервис и план правкой не меняются: это была бы другая карточка.

Правка ВКЛЮЧЁННОЙ карточки меняет публичную оферту немедленно. Если цена уходит вниз, это ваше дело; если вверх — покупатель, уже нажавший «купить», покупает по прежней: цена в заказе снимается слепком.

Поля запроса

Поле	Тип	Что это
`priceRub` обязательно	`integer`	Цена в рублях.
`productType` обязательно	`string`	Вид товара — тот же, что был.
`deliveryMethod` обязательно	`string`	Способ выдачи.
`slaMinutes` обязательно	`integer`	Обещанный срок выдачи.
`guaranteeDays` обязательно	`integer`	Срок гарантии.
`description`	`string`	Описание товара.

Поля ответа

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

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

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

Код	Что случилось и что делать
`not_found`	Записи нет или она не ваша. Условие владения стоит в самом запросе к базе, поэтому чужая запись выглядит как отсутствующая.
`complaint`	Правила карточки не сошлись: например, способ выдачи не подходит виду товара или срок вне допустимого списка. Допустимые значения отдаёт путь позиции справочника.
`contacts`	В тексте найдены контакты — почта, телефон, ссылка на мессенджер. Увод сделки за пределы площадки лишает покупателя защиты, а продавца гарантии. Уберите контакты и отправьте снова.
`type_not_available`	У этой позиции такого вида товара не бывает. Возможные виды — в ответе позиции справочника.
`self_employed_forbidden`	Самозанятый вправе продавать только подписку, оформляемую на почту покупателя: готовые аккаунты и токены — перепродажа, а она самозанятому запрещена законом.

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

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