Platitun · API · Карточки товара · Ответить на вопрос

Ответить на вопрос

POST /api/v1/questions/{id}/answer

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

Ответ публикуется в карточке сразу — в этом весь смысл: один и тот же вопрос задают десятки людей, и ответ, видный всем, экономит время обеим сторонам.

Поля запроса

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

Поля ответа

Поле	Тип	Что это
`service`	`string`	Позиция, страница которой обновилась.

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

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

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

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

GET /api/v1/listings — Свои карточки
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 — Вопросы по своим карточкам