PlatitunPlatitun · API · Сделка · Пожаловаться на покупателя
Пожаловаться на покупателя
POST /api/v1/complaintsОбласть ключа: orders · изменяет данные, нужен заголовок Idempotency-Key
Тема обязательна и берётся из классификатора: жалоба «просто плохой» не разбирается, а накопление однотипных нарушений считается само.
Поля запроса
| Поле | Тип | Что это |
|---|---|---|
topic обязательно | string | Тема из классификатора. |
text обязательно | string | Что случилось. |
orderId | string | Заказ, если жалоба о нём. Из него берётся, на кого жалоба. |
reviewId | string | Отзыв, если жалоба на отзыв. |
Поля ответа
| Поле | Тип | Что это |
|---|---|---|
ok | boolean | Жалоба принята. |
Поводы отказа
Отказ по правилам приходит как {"error":"rejected","refusal":{"kind":"…"}} с кодом 409. Общие для всех путей отказы — в разделе правил.
| Код | Что случилось и что делать |
|---|---|
need_topic | Нужна тема из классификатора: жалоба «просто плохой» не разбирается. |
too_short | Текст слишком короткий. Ответ в одно слово не помогает ни покупателю, ни разбору. |
not_found | Записи нет или она не ваша. Условие владения стоит в самом запросе к базе, поэтому чужая запись выглядит как отсутствующая. |
Рядом в этом разделе
GET /api/v1/orders— Свои заказы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— Свои жалобыGET /api/v1/work-mode— Режим работы и присутствиеPUT /api/v1/work-mode— Задать режим работы