PlatitunPlatitun · API · Справочник и заявки · Заявка на новую позицию каталога
Заявка на новую позицию каталога
POST /api/v1/catalog/requestsОбласть ключа: catalog · изменяет данные, нужен заголовок Idempotency-Key
Просьба добавить сервис или план, которых в справочнике нет. Заявка НИКОГДА не правит справочник сама: правку делает решение администратора — иначе на витрине появились бы два одинаковых товара с разными названиями.
Задваивание ловится ДО записи: если такой сервис или план уже есть, ответ назовёт его имя — искать самому не придётся.
Поля запроса
| Поле | Тип | Что это |
|---|---|---|
kind обязательно | string | «service» — новый сервис, «tariff» — новый план у существующего. |
serviceName | string | Название нового сервиса, как его пишет вендор. |
vendor | string | Кто его делает. |
categorySlug | string | В какой раздел справочника. |
productTypes | array | Какие виды товара по нему возможны. |
serviceSlug | string | Для плана: короткое имя сервиса, к которому он относится. |
tariffName | string | Название плана вендора. |
sourceUrl обязательно | string | Ссылка на официальную страницу вендора. Без неё проверить нечего. |
comment | string | Что важно знать администратору. |
Поля ответа
| Поле | Тип | Что это |
|---|---|---|
id | string | Номер заявки. |
selfAdded | boolean | Помечена ли заявка правом самостоятельного добавления. На модерацию она уходит всё равно. |
Поводы отказа
Отказ по правилам приходит как {"error":"rejected","refusal":{"kind":"…"}} с кодом 409. Общие для всех путей отказы — в разделе правил.
| Код | Что случилось и что делать |
|---|---|
catalog | Заявка собрана неверно: не хватает обязательного или ссылка не на официальную страницу вендора. |
already_in_catalog | Такая позиция в справочнике уже есть — ответ называет её. Заводите карточку по ней. |
already_requested | Такая заявка уже висит на модерации. Дождитесь решения. |
no_such_service | Сервиса, к которому вы просите добавить план, в справочнике нет. |
tariff_exists | Такой план у этого сервиса уже есть — ответ называет его. |
Рядом в этом разделе
GET /api/v1/me— Кто яGET /api/v1/catalog/services— Поиск позиции справочникаGET /api/v1/catalog/services/{slug}— Всё о позиции справочникаGET /api/v1/catalog/usual-price— Обычная цена по позицииGET /api/v1/catalog/demand— Спрос: чего ждут покупателиGET /api/v1/catalog/requests— Свои заявки на позицию каталога