Platitun · API · Справочник и заявки · Всё о позиции справочника

Всё о позиции справочника

GET /api/v1/catalog/services/{slug}

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

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

Модели внутри плана — то, чем карточка площадки отличается от карточки с одной ценой. Их стоит показать покупателю, а не прятать.

Поля ответа

Поле	Тип	Что это
`service`	`string`	Короткое имя сервиса.
`productTypes`	`array`	Возможные виды товара.
`deliveryMethods`	`object`	Какие способы выдачи допустимы каждому виду товара. Значения из ядра — разойтись с проверкой не могут.
`slaChoices`	`array`	Допустимые сроки выдачи в минутах.
`guaranteeChoices`	`array`	Допустимые сроки гарантии в днях.
`description`	`object`	Описание сервиса на двух языках.
`tariffs`	`array`	Планы вендора: короткое имя, название, срок, модели внутри и названные продукты.

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

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

Код	Что случилось и что делать
`not_found`	Записи нет или она не ваша. Условие владения стоит в самом запросе к базе, поэтому чужая запись выглядит как отсутствующая.

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

GET /api/v1/me — Кто я
GET /api/v1/catalog/services — Поиск позиции справочника
GET /api/v1/catalog/usual-price — Обычная цена по позиции
GET /api/v1/catalog/demand — Спрос: чего ждут покупатели
GET /api/v1/catalog/requests — Свои заявки на позицию каталога
POST /api/v1/catalog/requests — Заявка на новую позицию каталога