PlatitunPlatitun · API · Карточки товара · Одна своя карточка
Одна своя карточка
GET /api/v1/listings/{number}Область ключа: listings · только чтение
Все поля карточки, как их видит площадка, — включая признаки товара, из которых считается порядок на витрине.
Поля ответа
| Поле | Тип | Что это |
|---|---|---|
number | integer | Публичный номер. |
filled | integer | Сколько признаков товара заполнено — покупателю видно, насколько подробно описан товар. |
stockFree | integer|null | Сколько единиц склада свободно. |
Поводы отказа
Отказ по правилам приходит как {"error":"rejected","refusal":{"kind":"…"}} с кодом 409. Общие для всех путей отказы — в разделе правил.
| Код | Что случилось и что делать |
|---|---|
not_found | Записи нет или она не ваша. Условие владения стоит в самом запросе к базе, поэтому чужая запись выглядит как отсутствующая. |
Рядом в этом разделе
GET /api/v1/listings— Свои карточкиPOST /api/v1/listings— Завести карточку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— Пометить карточку тестовойPUT /api/v1/listings/{number}/image— Картинка карточкиDELETE /api/v1/listings/{number}/image— Убрать картинкуGET /api/v1/questions— Вопросы по своим карточкамPOST /api/v1/questions/{id}/answer— Ответить на вопрос