API Биосвет

1.     Общая информация

API предоставляет доступ к информации, размещенной на сайте https://www.biosvet.ru Обмен данными осуществляется по протоколу HTTPS. 

Аутентификация происходит при помощи полей Authorization-Login и Authorization-Password, передаваемых в HTTP HEADER. 

Важно! Логин и пароль для подключения выдается менеджером компании.


2.     Методы API

2.1. Полная выгрузка номенклатуры и остатков

Запрос:  GET https://www.biosvet.ru/api/v1/stock/full/

Формат ответа: JSON

Ключ Тип значения Описание
1 create yyyy-mm-dd hh:mm дата и время формирования выгрузки
2 stores array массив со списком складов
2.1 id int id склада
2.2 name varchar наименование склада
3 categories array массив со списком категорий товаров
3.1 id int id категории
3.2 name varchar наименование категории
4 products array массив со списком товаров
4.1 id int id товара
4.2 name varchar наименование товара
4.3 cat_id int id категории товара
4.4 price_rrc float рекомендованная розничная цена, руб.
4.5 price_opt float оптовая цена, руб.
4.6 weight int вес товара, граммы
4.7 unit varchar единица измерения товара
4.8 stock array массив со списком остатков по складам
4.8.1 id int id склада
4.8.2 amount int количество на складе
5 image varchar ссылка на фотографию товара
6 article varchar артикул товара
7 barcode varchar штрихкод товара
8 properties array массив со списком характеристик товара
8.1 name varchar название характеристики
8.2 value varchar значение характеристики


Пример запроса на PHP:

<?php

$url = 'https://www.biosvet.ru/api/v1/stock/full/';

$login = 'XXXXXX';

$password = 'XXXXXXXXX';

$headers = [

    'Authorization-Login: ' . $login,

    'Authorization-Password: ' . $password

];

$curl = curl_init($url);

curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);

curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

curl_setopt($curl, CURLOPT_FOLLOWLOCATION, true);

$response = curl_exec($curl);

curl_close($curl);

$f = fopen("biosvet_full.json","w");                                                    

file_put_contents("biosvet_full.json",$response);

fclose($f);

?>


Пример ответа:  

 [products] => Array
        (
            [0] => stdClass Object
                (
                    [id] => 28640
                    [name] => ODEON LIGHT 2056/8C ODL11 242 хром/"венге" Люстра потолочная  G9 8*40W 220V STAR
                    [cat_id] => 59
                    [price_rrc] => 15065
                    [price_opt] => 9320
                    [weight] => 0
                    [unit] => Штука
                    [description] => 
                    [stock] => Array
                        (
                            [0] => stdClass Object
                                (
                                    [id] => 1
                                    [amount] => 0
                                )

                            [1] => stdClass Object
                                (
                                    [id] => 2
                                    [amount] => 0
                                )

                            [2] => stdClass Object
                                (
                                    [id] => 3
                                    [amount] => 0
                                )

                        )

                    [image] => https://www.biosvet.ru/upload/iblock/70a/2056-8C.jpg
                    [article] => bs000914225
                    [barcode] => 4690344005579
                    [properties] => Array
                        (
                            [0] => stdClass Object
                                (
                                    [name] => Высота минимальная, мм
                                    [value] => 170
                                )

                            [1] => stdClass Object
                                (
                                    [name] => Высота встраиваемой части, мм..
                                    [value] => 30
                                )

                            [2] => stdClass Object
                                (
                                    [name] => Потребляемая мощность (W)
                                    [value] => 7
                                )

                            [3] => stdClass Object
                                (
                                    [name] => Диаметр, мм
                                    [value] => 495
                                )

                            [4] => stdClass Object
                                (
                                    [name] => Имя файла
                                    [value] => 2056-8C.jpg
                                )

                            [5] => stdClass Object
                                (
                                    [name] => Высота максимальная, мм
                                    [value] => 170
                                )

                            [6] => stdClass Object
                                (
                                    [name] => Диаметр колбы (мм)
                                    [value] => 45
                                )

                            [7] => stdClass Object
                                (
                                    [name] => Длина лампы (мм)
                                    [value] => 82
                                )

                            [8] => stdClass Object
                                (
                                    [name] => Индекс цветопередачи (Ra), не менее
                                    [value] => 80
                                )

                            [9] => stdClass Object
                                (
                                    [name] => ЯРТ
                                    [value] => 2056/8C
                                )

                            [10] => stdClass Object
                                (
                                    [name] => Серия
                                    [value] => STAR
                                )

                            [11] => stdClass Object
                                (
                                    [name] => Ставки налогов
                                    [value] => 18
                                )

                            [12] => stdClass Object
                                (
                                    [name] => Производитель.
                                    [value] => ODEON (пр-ль)
                                )

                            [13] => stdClass Object
                                (
                                    [name] => Актуальность
                                    [value] => Действующая позиция
                                )

                            [14] => stdClass Object
                                (
                                    [name] => Тип светильника
                                    [value] => люстры потолочные
                                )

                            [15] => stdClass Object
                                (
                                    [name] => Количество ламп
                                    [value] => 8
                                )

                            [16] => stdClass Object
                                (
                                    [name] => Стиль
                                    [value] => Модерн
                                )

                            [17] => stdClass Object
                                (
                                    [name] => Цвет корпуса/арматуры
                                    [value] => Хром
                                )

                            [18] => stdClass Object
                                (
                                    [name] => Патрон
                                    [value] => G9
                                )

                            [19] => stdClass Object
                                (
                                    [name] => Тип светильника.
                                    [value] => Накладной
                                )

                            [20] => stdClass Object
                                (
                                    [name] => Форма.
                                    [value] => Круглая
                                )

                            [21] => stdClass Object
                                (
                                    [name] => Цоколь
                                    [value] => E27
                                )

                            [22] => stdClass Object
                                (
                                    [name] => Тип светильника-
                                    [value] => Настенные
                                )

                            [23] => stdClass Object
                                (
                                    [name] => Встроенная LED-плата-
                                    [value] => Со встренной LED-платой
                                )

                            [24] => stdClass Object
                                (
                                    [name] => Управление светильником-
                                    [value] => Датчик движения
                                )

                            [25] => stdClass Object
                                (
                                    [name] => Комплект.
                                    [value] => Индивидуальное изделие
                                )

                            [26] => stdClass Object
                                (
                                    [name] => Напряжение (V)
                                    [value] => 220V
                                )

                            [27] => stdClass Object
                                (
                                    [name] => Напряжение, V,
                                    [value] => 12V
                                )

                            [28] => stdClass Object
                                (
                                    [name] => Доступ
                                    [value] => Нет
                                )

                            [29] => stdClass Object
                                (
                                    [name] => Тип комплектующих;
                                    [value] => Абажур
                                )

                            [30] => stdClass Object
                                (
                                    [name] => Новинка
                                    [value] => Да
                                )

                        )

                )

2.2. Краткая выгрузка номенклатуры и остатков

Запрос:  GET https://www.biosvet.ru/api/v1/stock/short/

Формат ответа: JSON

Ключ Тип значения Описание
1 create yyyy-mm-dd hh:mm дата и время формирования выгрузки
2 stores array массив со списком складов
2.1 id int id склада
2.2 name varchar наименование склада
3 categories array массив со списком категорий товаров
3.1 id int id категории
3.2 name varchar наименование категории
4 products array массив со списком товаров
4.1 id int id товара
4.2 name varchar наименование товара
4.3 cat_id int id категории товара
4.4 price_rrc float рекомендованная розничная цена, руб.
4.5 price_opt float оптовая цена, руб.
4.6 weight int вес товара, граммы
4.7 unit varchar единица измерения товара
4.8 stock array массив со списком остатков по складам
4.8.1 id int id склада
4.8.2 amount int количество на складе
5 image varchar ссылка на фотографию товара
6 article varchar артикул товара
7 barcode varchar штрихкод товара


Пример запроса на PHP:

<?php

$url = 'https://www.biosvet.ru/api/v1/stock/short/';

$login = 'XXXXXX';

$password = 'XXXXXXXXX';

$headers = [

    'Authorization-Login: ' . $login,

    'Authorization-Password: ' . $password

];

$curl = curl_init($url);

curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);

curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

curl_setopt($curl, CURLOPT_FOLLOWLOCATION, true);

$response = curl_exec($curl);

curl_close($curl);

$f = fopen("biosvet_short.json","w");                                                

file_put_contents("biosvet_short.json",$response);

fclose($f);

?>


Пример ответа:  

 [products] => Array
        (
            [0] => stdClass Object
                (
                    [id] => 28640
                    [name] => ODEON LIGHT 2056/8C ODL11 242 хром/"венге" Люстра потолочная  G9 8*40W 220V STAR
                    [cat_id] => 59
                    [price_rrc] => 15065
                    [price_opt] => 9320
                    [weight] => 0
                    [unit] => Штука
                    [stock] => Array
                        (
                            [0] => stdClass Object
                                (
                                    [id] => 1
                                    [amount] => 0
                                )

                            [1] => stdClass Object
                                (
                                    [id] => 2
                                    [amount] => 0
                                )

                            [2] => stdClass Object
                                (
                                    [id] => 3
                                    [amount] => 0
                                )

                        )

                    [image] => https://www.biosvet.ru/upload/iblock/70a/2056-8C.jpg
                    [article] => bs000914225
                    [barcode] => 4690344005579
                )