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
)