🔧
list_productstoolЧтение каталогаСписок опубликованных продуктов с поиском, фильтрами и пагинацией
Назначение
Возвращает опубликованные продукты каталога с полнотекстовым поиском по названию, краткому и полному описанию, фильтрами по категории и тегу.
Когда использовать
Когда нужно получить срез каталога: подобрать продукты по запросу, отфильтровать по категории или обойти каталог постранично.
Входные параметры
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
| search | string | нет | Поиск по названию, краткому и полному описанию |
| category | string | нет | Slug категории, например "crm" |
| tag | string | нет | Slug тега, например "saas" |
| page | number | нет | Номер страницы, по умолчанию 1 |
| pageSize | number | нет | Элементов на странице, максимум 100 |
Выход
{ items: Product[], pagination }
Ограничения
Возвращает только опубликованные продукты — черновики и архив в выдачу не попадают. pageSize ограничен 100 элементами.
Пример запроса и ответа
// Запрос
{ "search": "crm", "category": "crm", "pageSize": 10 }
// Ответ
{
"items": [
{
"slug": "red-crm",
"name": "Red CRM",
"status": "published",
"summary": "CRM для отдела продаж",
"seoTitle": "Red CRM — CRM для отдела продаж"
}
],
"pagination": { "page": 1, "pageSize": 10, "total": 1 }
}