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

products


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

HTTP Метод
GET

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

Параметри
Назва параметра Обов'язковий параметр Опис
categoryID так ідентифікатор категорії
SID так ідентифікатор сесії
vendorID ні ідентифікатор виробника
search ні рядок пошуку
filterID ні ідентифікатор фільтра
min_price ні мінімальна вартість товару (ціле число)
max_price ні максимальна вартість товару (ціле число)
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)

Рядок пошуку може бути двох видів:

1) рядок тексту - пошук здійснюється по рядку цілком. Приклад:
    Запит:
    http://api.brain.com.ua/products/125/gpkavk4s0aciujg6m698gev040?search=apple macbook pro

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

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

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


Результат
Метод повертає список товарів зазначеної категорії.

Якщо в запиті присутні необов'язкові параметри, то список товарів фільтрується у відповідності з ними.

Параметр "count" результату показує кількість товарів без урахування значень параметрів offset і limit.

Параметр stocks повертається тільки користувачам, авторизованим як дилер.

Приклад
    Запит:
    http://api.brain.com.ua/products/155/gpkavk4s0aciujg6m698gev040

    Відповідь:
    {
    "status":1,
    "result":
        {
        "list":
            [
            {
            "name":"Ноутбук Apple MacBook Pro",
            "stocks":[1,2,3],
            "brief_description":"короткий опис товара Apple MacBook Pro",
            "productID":101,
            "product_code":"S1234567",
            "warranty":"24",
            "is_archive":false,
            "vendorID":155,
            "articul":"MD311RS5 A",
            "volume":0.02,
            "is_new":false,
            "categoryID":155,
            "price": "1193.06",
            "price_uah": "10916.54",
            "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"
            },
            {
            "name":"Ноутбук Apple MacBook Pro2",
            "stocks":[1,2,3,4,5,6],
            "brief_description":"короткий опис товара Apple MacBook Pro2",
            "productID":102,
            "product_code":"S2345678",
            "warranty":"24",
            "is_archive":false,
            "vendorID":155,
            "articul":"RS555MD5 G",
            "volume":0.02,
            "is_new":false,
            "categoryID":155,
            "price": "1764.03",
            "price_uah": "16141.16",
            "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"
            }
            ],
        "count":2
        }
    }