Документация »

products_pictures


URL
http://api.brain.com.ua/products_pictures/categoryID/SID [?vendorID=vendorID] [&search=search] [&filterID=filterID] [&filters[]=filterID] [&limit=limit] [&offset=offset] [&sortby=field_name] [&order=order] [&lang=lang]

HTTP Метод
GET

Описание
Метод для получения адресов картинок товаров указанной категории и всех ее дочерних категорий

Параметры
Название параметра Обязательный параметр Описание
categoryID да идентификатор категории
SID да идентификатор сессии
lang нет язык, возможные значения - ua и ru
по умолчанию ua
vendorID нет идентификатор производителя
search нет строка поиска
filterID нет идентификатор фильтра
filters[] нет массив идентификаторов фильтров
limit нет количество возвращаемых товаров
(для пользователей без статуса OWN_MODE: максимальное значение - 100, значение по умолчанию - 100;
для пользователей со статусом OWN_MODE: максимальное значение - 1000, значение по умолчанию - 1000)
offset нет смещение (количество товаров, пропускаемых перед выводом результатов; по умолчанию - 0)
sortby нет параметр, по которому производится сортировка товаров
([name|brief_description|productID|product_code|warranty|is_archive|vendorID|articul|volume|is_new|categoryID],
по умолчанию - productID)
order нет порядок сортировки ([asc|desc], по умолчанию - asc)

Для фильтрации товаров можно использовать как одиночный фильтр filterID, так и массив фильтров filters[].Если указаны оба параметра, они будут использованы как общий массив фильтров.

Строка поиска может быть двух видов:

1) строка текста - поиск производится по строке целиком. Пример:
    Запрос:
    http://api.brain.com.ua/products_pictures/125/gpkavk4s0aciujg6m698gev040?search=apple macbook pro

    SQL:
    SELECT * FROM `products`
    WHERE `category_id`='125' AND
    `search_field_ru` LIKE '%apple macbook pro%'

2) строка JSON - поисковый запрос формируется из параметров, переданных в строке. Пример:
    Запрос:
    http://api.brain.com.ua/products_pictures/125/gpkavk4s0aciujg6m698gev040?lang=ua&search={"and":["appl",{"or":["pro","mini","i7"]}]}

    SQL:
    SELECT * FROM `products`
    WHERE `category_id`='125' AND
    `search_field_ua` LIKE '%appl%' AND (`search_field_ua` LIKE '%pro%' OR `search_field_ua` LIKE '%mini%' OR `search_field_ua` LIKE '%i7%')


Результат
Метод возвращает список адресов картинок товаров указанной категории.

Если в запросе присутствуют необязательные параметры, то список товаров фильтруется в соответствии с ними.

Пример
    Запрос:
    http://api.brain.com.ua/products_pictures/155/gpkavk4s0aciujg6m698gev040

    Ответ:
    {
    "status":1,
    "result":
        {
        "list":
            [
                {
                "productID":101,
                "pictures":
                    [
                        {
                        "priority":0,
                        "small_image":"https://opt.brain.com.ua/static/images/prod_img/6/7/S1234567_small.jpg",
                        "medium_image":"https://opt.brain.com.ua/static/images/prod_img/6/7/S1234567.jpg",
                        "large_image":"https://opt.brain.com.ua/static/images/prod_img/6/7/S1234567_big.jpg",
                        "full_image":"https://opt.brain.com.ua/static/images/prod_img/6/7/S1234567_main.jpg"
                        },
                        {
                        "priority":1,
                        "small_image":"https://opt.brain.com.ua/static/images/prod_img/6/7/S1234567_2small.jpg",
                        "medium_image":"https://opt.brain.com.ua/static/images/prod_img/6/7/S1234567_2.jpg",
                        "large_image":"https://opt.brain.com.ua/static/images/prod_img/6/7/S1234567_2big.jpg",
                        "full_image":"https://opt.brain.com.ua/static/images/prod_img/6/7/S1234567_2main.jpg"
                        }
                    ]
                },
                {
                "productID":"102",
                "pictures":
                    [
                        {
                        "priority":0,
                        "small_image":"https://opt.brain.com.ua/static/images/prod_img/7/8/S2345678_small.jpg",
                        "medium_image":"https://opt.brain.com.ua/static/images/prod_img/7/8/S2345678.jpg",
                        "large_image":"https://opt.brain.com.ua/static/images/prod_img/7/8/S2345678_big.jpg",
                        "full_image":"https://opt.brain.com.ua/static/images/prod_img/7/8/S2345678_main.jpg"
                        },
                        {
                        "priority":1,
                        "small_image":"https://opt.brain.com.ua/static/images/prod_img/7/8/S2345678_2small.jpg",
                        "medium_image":"https://opt.brain.com.ua/static/images/prod_img/7/8/S2345678_2.jpg",
                        "large_image":"https://opt.brain.com.ua/static/images/prod_img/7/8/S2345678_2big.jpg",
                        "full_image":"https://opt.brain.com.ua/static/images/prod_img/7/8/S2345678_2main.jpg"
                        },
                        {
                        "priority":2,
                        "small_image":"https://opt.brain.com.ua/static/images/prod_img/7/8/S2345678_3small.jpg",
                        "medium_image":"https://opt.brain.com.ua/static/images/prod_img/7/8/S2345678_3.jpg",
                        "large_image":"https://opt.brain.com.ua/static/images/prod_img/7/8/S2345678_3big.jpg",
                        "full_image":"https://opt.brain.com.ua/static/images/prod_img/7/8/S2345678_3main.jpg"
                        }
                    ]
                }
            ]
        }
    }