Platitun · API · Сделка · Написать покупателю

Написать покупателю

POST /api/v1/orders/{id}/messages

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

Сообщение в переписку заказа. Контакты в тексте не проходят: увод сделки за пределы площадки лишает покупателя защиты, а продавца — гарантии, и повторная попытка идёт в рейтинг.

Переписка закрывается вместе с заказом: у завершённого заказа она остаётся ЧИТАЕМОЙ, но писать в неё нельзя — придёт chat_read_only.

Поля запроса

Поле	Тип	Что это
`body` обязательно	`string`	Текст сообщения.

Поля ответа

Поле	Тип	Что это
`ok`	`boolean`	Сообщение отправлено.

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

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

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

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

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 — Отметить выдачу
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 — Задать режим работы