Platitun · API · Справочник и заявки · Обычная цена по позиции

Обычная цена по позиции

GET /api/v1/catalog/usual-price

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

Медиана живых карточек по позиции — ориентир, чтобы не поставить цену вдесятеро мимо рынка. Среднее перекашивает одна ошибочная цена, медиану — нет. Меньше трёх живых карточек: ответ «неизвестно», а не выдуманное число.

Настоящему продавцу тестовые карточки в медиану НЕ входят: медиана по ценам, по которым никто не покупает, — не ориентир. Тестовому ключу наоборот: других карточек у него и нет.

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

Поле	Тип	Что это
`service` обязательно	`string`	Короткое имя сервиса.
`productType` обязательно	`string`	Вид товара.

Поля ответа

Поле	Тип	Что это
`usualPriceRub`	`integer\|null`	Медиана в рублях. Пусто — сравнивать не с чем.

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

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

Код	Что случилось и что делать
`bad_request`	Запрос собран неверно: не хватает обязательного поля или значение не того вида. Подробность — в поле detail.

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

GET /api/v1/me — Кто я
GET /api/v1/catalog/services — Поиск позиции справочника
GET /api/v1/catalog/services/{slug} — Всё о позиции справочника
GET /api/v1/catalog/demand — Спрос: чего ждут покупатели
GET /api/v1/catalog/requests — Свои заявки на позицию каталога
POST /api/v1/catalog/requests — Заявка на новую позицию каталога