Kokhanenko: B2B Catalog API

Что умеет решение

Модуль Kokhanenko: B2B Catalog API добавляет к сайтам на 1С-Битрикс управляемый API для выгрузки каталога во внешние системы: дилерские кабинеты, партнёрские витрины, мобильные приложения, CRM, PIM, BI-отчёты и интеграционные сервисы.

Модуль предназначен не для массовой выгрузки прайс-листа, а для безопасной выдачи каталожных данных внешним системам, партнёрам, дилерам и клиентским приложениям через защищённый API с индивидуальными токенами и ограничениями доступа.

Решение позволяет предоставлять разным клиентам различные наборы данных, а не весь каталог сразу. Для каждого внешнего клиента создаётся отдельный API-токен; токены можно объединять в группы и настраивать ограничения по полям ответа, типам цен, разделам каталога и значениям свойств товаров.

API возвращает товары, активные разделы и количество доступных товаров. Поддерживаются форматы JSON и XML, постраничная выдача, авторизация по схеме Bearer, скачивание ответа файлом, а также публичная HTML-страница /api/ со справкой по endpoint-ам.

Решение подходит интернет-магазинам и B2B-порталам на 1С-Битрикс, а также компаниям, передающим каталог дилерам, партнёрам или франчайзи.

Модуль Kokhanenko: B2B Catalog API предназначен для интеграции внешних веб-сайтов, мобильных приложений, CRM, PIM и BI-систем с каталогом. Решение позволяет командам гибко управлять правами доступа к ценам, остаткам, свойствам товаров и разделам каталога.

Основные возможности включают работу с эндпоинтами товаров по адресам /api/v1/products, /api/v1/products.json и /api/v1/products.xml, а также эндпоинтом подсчета количества товаров /api/v1/products/count в форматах JSON и XML. Для работы с разделами доступен эндпоинт /api/v1/categories с поддержкой JSON и XML.

Аутентификация осуществляется через заголовок Authorization: Bearer. Обеспечена обратная совместимость с использованием query-параметра token. Система поддерживает создание групп токенов и настройку индивидуальных правил для каждого токена.

API предоставляет инструменты для ограничения возвращаемых полей, фильтрации доступных типов цен, исключения определенных разделов из выдачи и фильтрации товаров по значениям свойств. Механизм ACL применяется до этапа пагинации, обеспечивая согласованность подсчета доступного набора товаров для эндпоинтов /products и /products/count.

Дополнительно реализована возможность выбора свойств инфоблоков для внешней выгрузки, базовая выгрузка торговых предложений, цен и остатков. Ведется журнал API-запросов без сохранения полных токенов и строки запроса. В успешных ответах возвращаются служебные поля api_version: v1 и schema_version: 1.0.

Безопасность

Модуль не хранит полные токены в открытом виде в базе данных. Полное значение токена отображается только один раз при его создании или перевыпуске; в последующих административных списках виден лишь префикс. Для интеграций в промышленной среде рекомендуется использовать авторизацию Bearer, чтобы исключить попадание токена в URL, логи доступа и историю браузера. Журнал запросов фиксирует конечную точку, метод, статус, длительность, IP-адрес, идентификатор пользователя или токена, а также хэш строки запроса. Полные токены и исходные строки запроса в журнал не записываются.

General iT поможет установить модуль, настроить его и проверить работу на твоём сайте.