Общая информация
Конечная точка
Всё взаимодействие с API должно вестись по протоколу HTTPS. Базовый эндпоинт:
https://berg-air.ru/api/v1/
Используемый HTTP-метод: GET. Тип запроса указывается в пути. Параметры передаются в URL, например:
GET https://berg-air.ru/api/v1/brands/?id=1
Авторизация
Авторизация — Basic Auth. Учётные данные передаются в заголовке Authorization:
Authorization: Basic <credentials>
Где credentials — Base64-строка вида логин:пароль.
Учётные данные можно получить через форму «Запросить ключ». Дилер видит их в личном кабинете.
Формат данных
По умолчанию JSON. XML: параметр format=xml.
GET https://berg-air.ru/api/v1/brands/?format=xml
Ошибки
{ "error": "Неизвестный запрос." }
Коды: 401, 429, 404, 400.
Торговые предложения
Каждое активное ТП — отдельный товар в API. Товары без ТП тоже отдаются. У ТП: parent_id, is_offer=true.
Категории
Все категории
GET https://berg-air.ru/api/v1/categories/
| Поле | Описание |
|---|---|
| title | Название |
| chpu | Символьный код |
| level | ID родителя (0 — корень) |
| order | Сортировка |
Конкретная категория
GET https://berg-air.ru/api/v1/categories/?id=1
Бренды
Все бренды
GET https://berg-air.ru/api/v1/brands/
Конкретный бренд
GET https://berg-air.ru/api/v1/brands/?id=1
Продукты
Все продукты
GET https://berg-air.ru/api/v1/products/
GET https://berg-air.ru/api/v1/products/?limit=100&offset=0
| Поле | Описание |
|---|---|
| articul | Артикул |
| title | Название |
| category_id | ID категории |
| brand | ID бренда |
| price.ric / ric_currency | Цена BASE и валюта |
| description | Описание |
| images | Массив URL изображений |
| parent_id | ID родителя для ТП |
| is_offer | true для торгового предложения |
| techs | Характеристики (в карточке по id) |
Конкретный продукт
GET https://berg-air.ru/api/v1/products/?id=100
Технические характеристики
ТХ категории
GET https://berg-air.ru/api/v1/tech/?category=2
ТХ продукта
GET https://berg-air.ru/api/v1/tech/?id=100
Без параметров запрос не выполняется.