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

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

GET /api/v1/catalog/services

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

Справочник сервисов площадки. Он только читается: правит его администратор, и это не оговорка — два «Cursor Pro» с разными названиями покупатель не отличит. Выключенные сервисы наружу не отдаются вовсе.

Курсор — короткое имя последнего увиденного сервиса, а порядок по имени: он устойчив, в отличие от номера страницы.

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

Поле	Тип	Что это
`q`	`string`	Поиск по имени сервиса, вендору или короткому имени.
`category`	`string`	Только из этого раздела справочника.
`limit`	`integer`	Сколько записей вернуть. Умолчание 50, предел 200.
`cursor`	`string`	Значение nextCursor из прошлого ответа. Номеров страниц нет: пока листаешь, список меняется.

Поля ответа

Поле	Тип	Что это
`items`	`array`	Записи страницы.
`items[].service`	`string`	Короткое имя сервиса — им сервис называется во всех остальных путях.
`items[].name`	`string`	Название, как его пишет вендор.
`items[].vendor`	`string`	Кто делает сервис.
`items[].categories`	`array`	Разделы справочника: сервис бывает сразу в нескольких.
`items[].productTypes`	`array`	Какие виды товара по этой позиции возможны.
`items[].tariffCount`	`integer`	Сколько у сервиса планов вендора.
`nextCursor`	`string\|null`	Курсор следующей страницы. Пусто — страница последняя.

Пример

GET /api/v1/catalog/services?q=cursor&limit=2

→ 200 { "items": [ { "service": "cursor", "name": "Cursor", "vendor": "Anysphere",
        "productTypes": ["subscription","account_with_subscription","account"],
        "tariffCount": 3 } ], "nextCursor": null }

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

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