Документация для разработчиков

Findly подключается к любой витрине: JS-виджет с готовым UI или REST API, если интерфейс рисуете сами.

1. Виджет

<link rel="stylesheet" href="{HOST}/widget.css">
<link rel="stylesheet" href="{HOST}/api/widget/{WIDGET_KEY}/custom.css">
<script src="{HOST}/widget.js" data-findly-key="{WIDGET_KEY}" data-mode="modal"></script>
<input data-findly-search placeholder="Поиск по магазину">

Атрибут data-findly-search на существующем input открывает модалку. Кнопка с data-findly-open делает то же. Режим data-mode="inline" рисует свою строку рядом со скриптом.

2. CSS

:root {
  --fly-accent: #5B4CFF;
  --fly-radius: 16px;
  --fly-font: Manrope, sans-serif;
}

Дополнительный CSS каждого магазина хранится в кабинете и отдаётся по custom.css.

3. Поиск API

GET {HOST}/api/search?key={WIDGET_KEY}&q=айфон&offset=0&limit=24
     &category=&vendor=&inStock=1&sort=relevance|price_asc|price_desc|popular|new

Ответ: товары с фото, названием, ценой, артикулом, наличием, подсветкой, категории, фасеты, hasMore для бесконечной прокрутки, corrected при исправлении опечатки.

4. YML-фид

Формат Яндекс.Маркета: yml_catalog / shop / offers / offer. Поля: name, vendorCode, price, oldprice, picture, categoryId, vendor, url, description, param, available.

Обновление: автоматически по интервалу тарифа или кнопка «Обновить фид сейчас». Если офферов больше лимита тарифа, индекс обрезается, в кабинете владельца горит превышение.

Живой пример: демо-магазин.