Platitun · API · Сделка · Свои заказы

Свои заказы

GET /api/v1/orders

Область ключа: orders · только чтение

Заказы по вашим карточкам. Главный отбор — needsAction: он возвращает те, где ход за вами, и по нему одному можно вести работу. Отбор updatedSince — запасной путь к вебхукам: он есть всегда и переживает любую поломку доставки.

Кто купил, НЕ называется — ни почтой, ни ником. Площадка не показывает это продавцу и в кабинете.

Отбор в адресе

Поле	Тип	Что это
`needsAction`	`boolean`	Только те, где ход за вами: ждут подтверждения, ждут выдачи, открыт спор.
`status`	`string`	Только в этом состоянии.
`updatedSince`	`string`	Изменённые после этого времени. Время UTC строкой.
`limit`	`integer`	Сколько записей вернуть. Умолчание 50, предел 200.
`cursor`	`string`	Значение nextCursor из прошлого ответа. Номеров страниц нет: пока листаешь, список меняется.

Поля ответа

Поле	Тип	Что это
`items`	`array`	Записи страницы.
`items[].id`	`string`	Номер заказа.
`items[].status`	`string`	Состояние заказа.
`items[].amountMinor`	`integer`	Сумма в копейках — слепком на момент заказа.
`items[].listing`	`integer`	Номер карточки.
`items[].deadlineAt`	`string\|null`	До какого времени ход за вами.
`nextCursor`	`string\|null`	Курсор следующей страницы. Пусто — страница последняя.

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

GET /api/v1/orders/{id} — Один заказ
POST /api/v1/orders/{id}/confirm — Взять заказ
POST /api/v1/orders/{id}/decline — Отказаться от заказа
POST /api/v1/orders/{id}/deliver — Отметить выдачу
POST /api/v1/orders/{id}/messages — Написать покупателю
GET /api/v1/orders/{id}/handover — Сейфы заказа
POST /api/v1/orders/{id}/handover — Положить доступ в сейф
POST /api/v1/orders/{id}/handover/reveal — Прочитать сейф покупателя
POST /api/v1/orders/{id}/dispute/reply — Ответить в споре
GET /api/v1/reviews — Отзывы о себе
POST /api/v1/reviews/{id}/reply — Ответить на отзыв
GET /api/v1/complaints — Свои жалобы
POST /api/v1/complaints — Пожаловаться на покупателя
GET /api/v1/work-mode — Режим работы и присутствие
PUT /api/v1/work-mode — Задать режим работы