Platitun · API · Карточки товара · Свои карточки
Свои карточки
GET /api/v1/listingsОбласть ключа: listings · только чтение
Все ваши карточки с ценой, складом и состоянием. Чужих здесь не бывает: условие владения стоит в самом запросе к базе, а не проверяется после.
Отбор в адресе
| Поле | Тип | Что это |
|---|---|---|
active | boolean | Только включённые (true) или только выключенные (false). |
service | string | Только по этой позиции справочника. |
limit | integer | Сколько записей вернуть. Умолчание 50, предел 200. |
cursor | string | Значение nextCursor из прошлого ответа. Номеров страниц нет: пока листаешь, список меняется. |
Поля ответа
| Поле | Тип | Что это |
|---|---|---|
items | array | Записи страницы. |
items[].number | integer | Публичный номер карточки. |
items[].priceMinor | integer | Цена в копейках. |
items[].isActive | boolean | На витрине или снята. |
items[].isTest | boolean | Тестовая карточка: её купит только тестовый покупатель. |
items[].stock | integer|null | Остаток. Пусто — склад не ограничен. |
items[].autoIssue | boolean | Выдаёт ли склад сам. |
nextCursor | string|null | Курсор следующей страницы. Пусто — страница последняя. |
Рядом в этом разделе
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— Копия карточки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— Ответить на вопрос