Интеграция поиска без флага fullData

Метод предполагает, что Search API возвращает только идентификаторы товаров (id) и минимальные служебные атрибуты. Все отображаемые данные — название, цена, изображение, ссылка — подтягиваются из собственной базы данных или кеша платформы по полученным ID.

Это рекомендуемый метод для production-интеграции: он быстрее, снижает нагрузку на API и даёт полный контроль над отображаемыми данными.

Схема показывает полный путь запроса — от браузера до объединённого ответа фронтенду. Блок Autocomplete API участвует только если на проекте интегрированы автоподсказки.

Обязательные

Рекомендуемые

Дополнительные параметры (из Swagger, расширенный набор)

Параметры ниже описаны в Swagger, но используются реже. Большинство клиентов работает с основным набором выше; дополнительные параметры применяются в особых сценариях или тонкой настройке.

{
  "totalHits": 284,
  "zeroQueries": false,
  "correction": "кроссовки",
  "products": [
    { "id": "45678", "available": true,  "score": 0.987 },
    { "id": "45699", "available": true,  "score": 0.951 }
  ],
  "facets": [...],
  "selectedFacets": [...]
}

Поля ответа

Полный список полей товара (доступны при fullData=true): groupId, ids[], name, brand, link_url, image_url, image_urls[], price, oldPrice, alternative, categories[], attributes{}, skuChoiceAttributes[], skus[], rating, totalRatings. Подробнее — в документе fullData=true.

Поле zeroQueries сигнализирует о нулевом ранжировании.

При withCorrection=true ответ содержит поле correction.

Если correction отличается от исходного st — показать пользователю плашку:

Если на вашем проекте интегрированы автоподсказки, в результаты выдачи должен передаваться запрос пользователя после исправления и дописывания — эти операции выполняются в API Autocomplete.

Схема передачи correction

// 1. Пользователь вводит запрос
const userInput = "кросовки"
// 2. Запрос к Autocomplete API (происходит при вводе)
const autocompleteResponse = await fetch(
  `https://autocomplete.diginetica.net/autocomplete?st=${userInput}&apiKey=YOUR_API_KEY`
)
const autocompleteData = await autocompleteResponse.json()
// 3. Берём исправленный запрос из поля correction
const correction = autocompleteData.correction ?? userInput
// correction = "кроссовки"
// 4. Передаём correction в параметр st API sort
const searchResponse = await fetch(
  `https://sort.diginetica.net/search?st=${encodeURIComponent(correction)}&apiKey=YOUR_API_KEY&strategy=...`
)

Что куда передавать

Фасеты возвращаются при withFacets=true. Структура одного фасета:

{
  "name": "Бренд",
  "dataType": "DISTINCT",
  "values": [
    { "id": "Nike",   "name": "Nike",   "value": 34 },
    { "id": "Adidas", "name": "Adidas", "value": 28 }
  ]
}

Типы фасетов

Пример UI: sticky-фасеты

Фасеты рекомендуется закреплять при скролле (position: sticky), чтобы пользователь мог применять фильтры не возвращаясь наверх страницы.

CSS для sticky-фасетов

.search-layout {
  display: flex;
  gap: 24px;
  align-items: flex-start;
}
.facets-panel {
  width: 220px;
  position: sticky;
  top: 24px;
  max-height: calc(100vh - 48px);
  overflow-y: auto;
}
.results-col {
  flex: 1;
  min-width: 0;
}

Синтаксис фильтров

Search API использует offset-based пагинацию.

Страница 1: size=20&offset=0
Страница 2: size=20&offset=20
Страница 3: size=20&offset=40

const totalPages = Math.ceil(response.totalHits / size)

Таймаут для /search — 2000 мс.

После каждого поискового запроса отправить событие SEARCH_EVENT на tracking-app.diginetica.net/event.

Поля события SEARCH_EVENT

Когда отправлять

Пример тела события

{
  "eventType": "SEARCH_EVENT",
  "sessionId": "[UUID]",
  "userGUID": "0:kzmrfk1k:[UUID]",
  "apiKey": "YOUR_API_KEY",
  "location": "https://example.com/search?q=кросовки",
  "referer": "https://example.com/",
  "regionId": "msk",
  "viewGUID": "[UUID]",
  "searchTerm": "кроссовки",
  "originalSearchTerm": "кросовки",
  "channel": "WEB",
  "pageProducts": ["45678", "45699", "45700"],
  "pageNumber": 1,
  "isZeroQuery": "false",
  "anyQueryWorked": "true"
}

• apiKey не передаётся с фронтенда — используется серверный прокси
• Таймаут 2000 мс настроен, fallback на стандартный поиск реализован
• Порядок товаров из API сохраняется после обогащения данными из БД
• Обрабатывается zeroQueries: true при totalHits > 0 — показываются альтернативные товары с плашкой
• Обрабатывается zeroQueries: true при totalHits = 0 — показывается страница нулевой выдачи
• Отправляется трекинг-событие SEARCH_EVENT на каждую страницу выдачи
• searchTerm в трекинге — исправленный запрос (при наличии Autocomplete — correction из Autocomplete API)
• Если интегрирован Autocomplete — в параметр st API sort передаётся поле correction из ответа Autocomplete API
• Пагинация реализована через offset, не дублирует товары
• Товары, не найденные в БД, фильтруются без ошибки
• Фасеты запрашиваются в том же запросе через withFacets=true
• Фасеты закреплены при скролле (position: sticky)
• Недоступные товары при showUnavailable=true отображаются с пометкой, не скрываются
• При исправлении запроса пользователю показывается плашка с оригинальным вариантом