Что лежит в каталоге

Цифры считаются прямо из базы и обновляются автоматически — это не картинка в вёрстке.

430 386: позиций всего
59 862: в актуальных коллекциях
305: брендов
82 796: моделей
275 253: позиций с фото
324 546: позиций контактных линз

Каталог содержит и снятые с производства модели — они нужны, чтобы опознать остатки и старые коллекции. Актуальность каждой позиции видна в поле статуса.

Как забрать данные

Два способа под разные команды: запрос из вашей системы или файл, который откроет любой сотрудник.

REST API

Для интеграции с сайтом, товароучётной системой или маркетплейсом.

Фильтры по бренду, модели, типу, полу, форме, материалу и десяткам других полей
Курсорная пагинация — полный каталог выкачивается без пропусков и дублей
Инкремент по изменениям: забираете только то, что поменялось с прошлого раза

Выгрузка в Excel

Для тех, кому нужен файл, а не интеграция. Настраивается без программиста.

Выбираете бренды, фильтры и набор колонок — сохраняете как шаблон
Перед запуском видно, сколько позиций попадёт в файл
Большие выгрузки готовятся в фоне, ссылка приходит в кабинет

Фотографии

Снимки товаров с прозрачным фоном, пригодные для витрины и маркетплейса.

В API — прямые ссылки на изображения в каждой позиции
В выгрузке — отдельный архив, разложенный по брендам и моделям
Внутри архива опись: какому штрихкоду какие файлы соответствуют

Как выглядит ответ

Настоящие данные из каталога — не пример из документации.

Запрос

GET /v1/products?brand=RAY-BAN&has_photo=true&limit=2

Ответ

{
  "data": [
    {
      "ean": "805289003472",
      "brand": "RAY-BAN",
      "model": "RB3136",
      "name": "RB3136 001 58",
      "color": "GOLD",
      "size": "58",
      "gender": "UNISEX",
      "material": "METAL",
      "rrp": 169,
      "currency": "EUR",
      "status": "ACTIVE",
      "images": [
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/805289003472.png"
      ]
    },
    {
      "ean": "8056262017838",
      "brand": "RAY-BAN",
      "model": "RX5425D",
      "name": "RX5425D 2012 54",
      "color": "TORTOISE",
      "size": "54",
      "gender": "UNISEX",
      "material": "ACETATE",
      "rrp": 169,
      "currency": "EUR",
      "status": "ACTIVE",
      "images": [
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8056262017838.jpg"
      ]
    }
  ],
  "meta": {
    "returned": 2,
    "cursor": null
  }
}

Набор полей вы задаёте сами: если нужны только штрихкод, цена и ссылка на фото, ответ будет содержать ровно их. Полный перечень полей отдаёт метод /v1/meta — по нему удобно собирать интеграцию.

Частые вопросы

Есть ли в каталоге остатки?

Нет. Каталог — это справочник: атрибуты, фотографии, штрихкоды и рекомендованные цены. Наличие на складе живёт в другой системе, и в этих данных его нет. Говорим об этом сразу, чтобы не расходились ожидания.

Какие цены вы отдаёте?

Рекомендованные розничные — те, по которым бренд предлагает продавать. Закупочные цены не передаём ни в API, ни в выгрузках.

Можно ли использовать фотографии у себя на сайте?

Да, ради этого каталог чаще всего и берут. В API приходят прямые ссылки на изображения, в выгрузке — архив с файлами и описью.

Как часто обновляются данные?

Каталог пополняется постоянно, по мере поступления данных от брендов. В API есть метод, отдающий только изменения с указанной даты, — выкачивать всё заново не нужно.

Как оплатить?

Пока выставляем счёт: автоматической оплаты картой на сайте нет. Когда появится, действующим клиентам ничего менять не придётся.

Контактные линзы тоже есть?

Да, отдельным разделом: кривизна, диоптрии, цилиндр, ось, аддидация, упаковка и цена. Фотографий у линз в базе нет — для них они мало что дают.