Kokhanenko: B2B Catalog API
Скриншоты
Технические данные
Совместимые редакции
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Старт
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Стандарт
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Малый бизнес
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Бизнес
Описание
Kokhanenko: B2B Catalog API добавляет к сайту на 1С-Битрикс управляемый API для выгрузки каталога во внешние системы: дилерские кабинеты, партнёрские витрины, мобильные приложения, CRM, PIM, BI-отчёты и интеграционные сервисы.
Модуль предназначен не для массовой выгрузки прайс-листа, а для безопасной выдачи каталожных данных внешним системам, партнёрам, дилерам и клиентским приложениям через защищённый API с индивидуальными токенами и ограничениями доступа.
Модуль помогает отдавать не весь каталог всем подряд, а разные наборы данных разным клиентам. Для каждого внешнего клиента можно создать отдельный API-токен, объединить токены в группы и настроить ограничения по полям ответа, типам цен, разделам каталога и значениям свойств товаров.
API возвращает товары, активные разделы и количество доступных товаров. Поддерживаются JSON и XML, постраничная выдача товаров, Authorization: Bearer, скачивание ответа файлом и публичная HTML-страница /api/ с короткой справкой по endpoint-ам.
Кому подходит- интернет-магазинам и B2B-порталам на 1С-Битрикс;
- компаниям, которые передают каталог дилерам, партнёрам или франчайзи;
- проектам, где нужно подключить внешний сайт, мобильное приложение, CRM, PIM или BI-систему;
- командам, которым важно разделять доступ к ценам, остаткам, свойствам и разделам каталога.
- Endpoint товаров: /api/v1/products, /api/v1/products.json, /api/v1/products.xml.
- Endpoint количества товаров: /api/v1/products/count, включая JSON/XML-форматы.
- Endpoint разделов: /api/v1/categories, включая JSON/XML-форматы.
- Авторизация через Authorization: Bearer.
- Legacy-совместимость через query-параметр token.
- Группы токенов и индивидуальные правила для токенов.
- Ограничение полей ответа.
- Ограничение доступных типов цен.
- Исключение разделов из выдачи.
- Фильтрация товаров по значениям свойств.
- ACL до пагинации товаров: /products и /products/count считают доступный набор одинаково.
- Выбор свойств инфоблока, которые можно отдавать наружу.
- Базовая выгрузка торговых предложений, цен и остатков.
- Журнал API-запросов без сохранения полного токена и query string.
- Служебные поля api_version: v1 и schema_version: 1.0 в успешных ответах.
Модуль не хранит полный plain-token в базе. Полное значение токена показывается только один раз при создании или перевыпуске, а дальше в административных списках отображается только префикс. Для production-интеграций рекомендуется использовать Bearer-авторизацию, чтобы токен не попадал в URL, access-логи и историю браузера.
Журнал запросов хранит endpoint, метод, статус, длительность, IP, ID/пользователя токена и hash query string. Полный токен и исходная query string в журнал не записываются.
- Установите модуль стандартным способом в административной части Bitrix.
- В настройках модуля включите API и выберите инфоблок каталога.
- При необходимости укажите инфоблок торговых предложений.
- Выберите коды свойств, которые разрешено отдавать через API.
- Проверьте route-файл /local/routes/kokhanenko_catalogapi.php и routing-настройки проекта.
- Создайте группу токенов и API-токен для внешнего клиента.
- Проверьте доступ запросом к /api/v1/products/count.
curl -H "Authorization: Bearer htm_xxxxxxxxxxxxxxxxxxxxx" \ "https://example.ru/api/v1/products/count" |
curl -H "Authorization: Bearer htm_xxxxxxxxxxxxxxxxxxxxx" \ "https://example.ru/api/v1/products?page=1&limit=10&pretty=1" |
❓ Обратная связь и поддержка
По вопросам работы модуля, а также предложениям по добавлению новой функциональности, вы можете обращаться по электронной почте: info@kokhanenko.pro. Время работы с 09-18 (Врем Московское). Время реагирование на запрос до часа.
Установите этот модуль прямо сейчас!
Для этого укажите адрес сайта:
