AnyImages — серверная интеграция

Обзор

AnyImages — сервис поиска товаров по изображениям. Интеграция выполняется на серверной стороне в реальном времени. Браузер пользователя никогда не обращается к API напрямую.

Сценарии использования

Архитектура

Все запросы к AnyImages API проходят через ваш сервер. Сжатие и валидация изображений выполняются также на сервере.

Эндпоинт

Тело запроса — multipart/form-data.

Параметры запроса

Все параметры передаются в теле запроса как поля multipart/form-data.

Логика параметров

Набор передаваемых параметров зависит от сценария:

Требования к изображению

• Поддерживаемые форматы: jpg, jpeg, png, webp
• Оптимальный размер — 1024px по длинной стороне
• Максимальный размер файла — 10 МБ; файлы большего размера отклоняются. Рекомендуется сжатие при превышении ~1–2 МБ для ускорения передачи.

Примеры запросов

Поиск через строку поиска (пользователь загрузил фото)

curl --location 'https://api.diginetica.net/v1/imagesearch/search?apiKey=API-KEY' \
  --form 'image=@"picture.jpg"' \
  --form 'productsSize="20"' \
  --form 'showUnavailable="true"' \
  --form 'deboostUnavailable="true"' \
  --form 'regionId="25"'

Поиск по кнопке «Найти похожие» на карточке товара

Сервер по offer_id товара получает URL его основного изображения из своей БД, скачивает изображение и отправляет его на API как обычный параметр image:

curl --request POST \
  --url 'https://api.diginetica.net/v1/imagesearch/search?apiKey=API-KEY' \
  --header 'content-type: multipart/form-data' \
  --form 'image=@"product_image.jpg"' \
  --form 'productsSize="30"' \
  --form 'showUnavailable="true"' \
  --form 'deboostUnavailable="true"' \
  --form 'regionId="msk"'

Структура ответа

Ответ содержит массив объектов products в порядке убывания релевантности.

{
  "products": [
    {
      "id": "85234",
      "groupId": "85234",
      "available": false,
      "name": "Торшер Loft IT Eye",
      "brand": "Loft IT",
      "price": "26235.0",
      "score": 1.0,
      "categories": [
        {
          "id": "52",
          "name": "торшеры",
          "direct": false,
          "link_url": "...",
          "image_url": "..."
        }
      ],
      "attributes": {
        "интерьер": ["Для гостиной"],
        "материал арматуры": ["Металл"]
      },
      "skus": [
        {
          "id": "85234",
          "available": false,
          "name": "Торшер Loft IT Eye",
          "price": "26235.0",
          "attributes": {},
          "link_url": "...",
          "image_url": "..."
        }
      ],
      "ids": ["85234"],
      "link_url": "...",
      "image_url": "..."
    }
  ]
}

Описание полей

Ошибки

Безопасность

• API-ключ хранить только на сервере. Не передавать на фронтенд, не вставлять в браузерный код.
• Ключ передаётся через query-параметр apiKey в запросе от сервера к API.
• Настройте ротацию ключей и мониторинг использования (анализ RPS, аномалий).
• При необходимости ограничьте источники запросов: IP allowlist, прокси.
• CORS не нужен — запросы к API выполняет ваш сервер, не браузер.

Лимиты и таймауты

• Рекомендуемый клиентский таймаут — 30 секунд (по спецификации API). Поиск по изображению — более долгая операция, чем текстовый поиск.
• Ограничьте конкурентность вызовов, добавьте очереди/воркеры для пиковой нагрузки.
• Кэшируйте пустые результаты на короткое время, чтобы не повторять запросы по одному и тому же изображению.

Трекинг и разметка

Команда Any настраивает трекинг на своей стороне. От вас требуется разметка HTML-блоков выдачи на фронтенде.

Что отслеживается

• Вызов поиска по фото
• Загрузка фотографии
• Клик по кнопке «Похожие» на товаре
• Кроп выделенной области на фото
• Клик по товару из результатов выдачи
• Добавление товара в корзину из результатов выдачи (если есть кнопка)

Необходимая разметка

Добавьте уникальный id родительскому элементу блока выдачи и атрибут с offer ID каждой карточке товара.

<div id="digi-image-search">
    <div class="digi-product" product-id="33526">
        <!-- Контент карточки товара -->
    </div>
    <div class="digi-product" product-id="33527">
        <!-- Контент карточки товара -->
    </div>
</div>