Интеграция поиска с флагом fullData=true

При fullData=true Search API возвращает полные данные каждого товара прямо в ответе — идентификатор, название, цену, изображение, ссылку и дополнительные атрибуты. Обращаться к собственной базе данных не нужно.

Это упрощённый метод интеграции, подходящий для быстрого старта, прототипов и случаев, когда нет доступа к собственной БД товаров на бэкенде.

В отличие от fullData=false, здесь нет шага обогащения данными из БД — Search API возвращает всё необходимое в одном ответе. Блок Autocomplete API участвует только если на проекте интегрированы автоподсказки.

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

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

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

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

Поле 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)}&fullData=true&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-фасеты

Фасеты рекомендуется закреплять при скролле — для этого контейнер демо ниже имеет фиксированную высоту и overflow-y: auto, а панель фасетов — position: sticky; top: 0. Прокрути список товаров вправа — фасеты остаются на месте.

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

.search-layout {
  display: flex;
  gap: 24px;
  align-items: flex-start;
  max-height: calc(100vh - 48px);
  overflow-y: auto;
}
.facets-panel {
  width: 220px;
  min-width: 220px;
  position: sticky;
  top: 0;
  align-self: flex-start;
}
.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"
}

• fullData=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
• Недоступные товары при showUnavailable=true отображаются с пометкой, не скрываются
• При исправлении запроса пользователю показывается плашка с оригинальным вариантом
• Поле oldPrice используется для отображения зачёркнутой цены при наличии скидки