ZOOMOS API

API ZOOMOS доступно только авторизованным пользователям. Идентификация происходит с помощью авторизационных ключей, выдаваемых системой ZOOMOS.

Авторизационный ключ необходимо передавать во всех запросах GET-параметром key. Если ресурс API вызван без авторизационного ключа или в запросе передан недействительный ключ, сервер ZOOMOS возвращает ошибку.

Пример: https://api.zoomos.by/pricelist?key=api-help

Получение прайслиста

https://api.zoomos.by/pricelist - только активные позиции

https://api.zoomos.by/pricelist?all=1 - все позиции

Для получения «облегчённой» версии прайслиста используйте параметры:

supplierInfo=0 - без информации о поставщиках

warrantyInfo=0 - без информации о гарантии

competitorInfo=0 - без информации о конкурентах

deliveryInfo=0 - без информации о доставке

offset и limit - ограничение кол-ва строк. offset - номер позиции, с которой начинается выдача (обычно offset = limit * n)

Также для ускорения загрузки используйте HTTP-заголовок Accept-Encoding: gzip, deflate (https://en.wikipedia.org/wiki/HTTP_compression)

Другие параметры:

checkImages - проверять наличие картинок (увеличивает время ответа)

Выходные данные: список offer

Примеры:

https://api.zoomos.by/pricelist?key=api-help

https://api.zoomos.by/pricelist?all=1&key=api-help

https://api.zoomos.by/pricelist?key=api-help&supplierInfo=0&warrantyInfo=0&competitorInfo=0&deliveryInfo=0

https://api.zoomos.by/pricelist?key=api-help&offset=5&limit=5

https://api.zoomos.by/pricelist?key=api-help&offset=10&limit=5

https://api.zoomos.by/pricelist?key=api-help&offset=100&limit=5

https://api.zoomos.by/pricelist?key=api-help&checkImages=1

Получение прайслиста площадки

https://api.zoomos.by/pricelist/{portal} - только активные позиции

{portal} - код площадки

Выходные данные: список offer

Примеры:

https://api.zoomos.by/pricelist/yandex?key=api-help

https://api.zoomos.by/pricelist/onliner?key=api-help

Получение списка категорий

https://api.zoomos.by/categories

Пример: https://api.zoomos.by/categories?key=api-help

Получение списка товаров в категории

https://api.zoomos.by/category/{categoryId}/offers

{categoryId} - ID категории в ZOOMOS

Выходные данные: список offer

Примеры:

https://api.zoomos.by/category/595/offers?key=api-help

https://api.zoomos.by/category/595/offers?all=1&key=api-help

Получение описания товара

https://api.zoomos.by/item/{itemId}

{itemId} - ID товара в ZOOMOS

Выходные данные: item

Внимание! Характеристики товара находятся в filters. Атрибут features больше не поддерживается.

Пример: https://api.zoomos.by/item/178782?key=api-help

Получение информации о предложении

https://api.zoomos.by/offer/{itemId}

{itemId} - ID товара в ZOOMOS

Выходные данные: offer

Пример: https://api.zoomos.by/offer/178782?key=api-help

Поиск по модели

https://api.zoomos.by/offers/search?q={query}

{query} - строка для поиска

Выходные данные: список offer

Примеры:

https://api.zoomos.by/offers/search?q=samsung&key=api-help

https://api.zoomos.by/offers/search?q=телевизор&key=api-help

https://api.zoomos.by/offers/search?q=indesit%20машина%20стиральная&key=api-help

Список фильтров категории

https://api.zoomos.by/category/{categoryId}/filters

{categoryId} - ID категории в ZOOMOS

Пример: https://api.zoomos.by/category/1475/filters?key=api-help

Подбор по параметрам (фильтрация)

https://api.zoomos.by/category/{categoryId}/filter

Описание параметров:

Параметр	Тип	Значение
categoryId	Число	ID категории в ZOOMOS
vendorId	Число	ID производителя в ZOOMOS
priceMin	Число	Минимальная цена
priceMax	Число	Максимальная цена
filterId	Число	ID фильтра в ZOOMOS * тип фильтра `numeric` — числовое значение {value} или числовой диапазон, значения границ которого разделяются запятой {min_value},{max_value}; * тип фильтра `enum` — список идентификаторов допустимых значений фильтра, разделенный запятыми, {value1_id},{value2_id},{value3_id}, где {valueN_id} — идентификатор значения; * тип фильтра `bool` — допустимые значения фильтра: 1 и 0.

Примеры:

https://api.zoomos.by/category/1475/filter?vendorId=1574&priceMin=200&priceMax=5061&f366=4643,4628&key=api-help

https://api.zoomos.by/category/1433/filter?f1657=1&key=api-help

Изображения товара

Получение главного фото товара:

https://api.zoomos.by/img/item/{itemId}/main

{itemId} - ID товара в ZOOMOS

Пример: https://api.zoomos.by/img/item/241293/main

Получение уменьшенного фото товара:

https://api.zoomos.by/img/item/{itemId}/{n}/resize/{x}x{y}

{x}x{y} - необходимый размер

{n} - номер фото либо main

Примеры:

https://api.zoomos.by/img/item/241293/main/resize/350x300

https://api.zoomos.by/img/item/241293/2/resize/450x500

Новые товары

Формируются исходя из последнего обновления.

https://api.zoomos.by/offers/new - по всем категориям

https://api.zoomos.by/category/{categoryId}/offers/new - по заданной категории

limit - ограничение кол-ва строк

Выходные данные: список offer

Примеры:

https://api.zoomos.by/offers/new?key=api-help

https://api.zoomos.by/offers/new?key=api-help&limit=5

https://api.zoomos.by/category/1433/offers/new?key=api-help

Товары со скидкой

https://api.zoomos.by/offers/discounts - по всем категориям

https://api.zoomos.by/category/{categoryId}/offers/discounts - по заданной категории

Выходные данные: список offer

Примеры:

https://api.zoomos.by/offers/discounts?key=api-help

https://api.zoomos.by/category/595/offers/discounts?key=api-help

Список предложений по ID

https://api.zoomos.by/offers?ids={itemIds} - список предложений

{itemIds} - ID товаров в ZOOMOS

Ограничение: 500 позиций

Выходные данные: список offer

Примеры:

https://api.zoomos.by/offers?ids=175361,225970,42282&key=api-help

Список товаров по ID

https://api.zoomos.by/items?ids={itemIds} - список описаний

{itemIds} - ID товаров в ZOOMOS

Ограничение: 500 позиций

Выходные данные: список item

Примеры:

https://api.zoomos.by/items?ids=69994,208888,284404&key=api-help

Список предложений конкурентов

GET|POST https://api.zoomos.by/competitors/{portal}

{portal} - код площадки

Для получения «облегчённой» выдачи используйте параметры:

onlyWithCompetitors=1 - только с конкурентами

showModel=0 - без названия товара

showPrice=0 - без цены

showProductName=0 - без названия товара конкурента

Описание дополнительных параметров:

Параметр	Значение	Описание
competitor	Строка	конкурент
category	Строка	категория
city	Число	ID города
productId	Строка	код товара
splitSellers	1/0	разделение продавцов при наличии
showProductId	1/0	вывод кода товара конкурента
showDate	1/0	вывод даты цены конкурента
allCompetitors	1/0	вывод цен конкурентов не в наличии
competitorsWithoutPrices	1/0	вывод конкурентов без цен
site	Строка	вывод информации по указанным конкурентам (доменам)