Kokhanenko: B2B Catalog API

Контролируемый доступ к каталогу для каждого внешнего партнёра

Модуль «Kokhanenko: B2B Catalog API» превращает сайт на 1С-Битрикс в управляемый источник данных. Вместо того чтобы выгружать весь прайс-лист одним файлом, вы получаете возможность раздавать информацию дозированно. Каждому дилеру, партнёру или мобильному приложению — свой набор данных. Система работает через защищённые API-токены: для каждого внешнего клиента вы создаёте отдельный ключ, объединяете их в группы и назначаете персональные правила. Это значит, что один партнёр видит только оптовые цены и определённые разделы, а другой — розничные цены и расширенный перечень свойств. Никакой случайной утечки коммерческой информации.

Гибкая настройка фильтров: от полей ответа до свойств товаров

Вы сами решаете, какие данные отдавать наружу. В настройках токена можно исключить целые разделы каталога, ограничить типы цен, скрыть или показать конкретные поля ответа. Фильтрация работает и на уровне свойств товаров: например, вы можете разрешить выдачу только тех позиций, у которых заполнен артикул или указан определённый бренд. Все ограничения применяются до пагинации, поэтому эндпоинты /products и /products/count считают доступный набор товаров одинаково. Это избавляет от путаницы, когда количество позиций в списке не совпадает с результатом подсчёта.

Три ключевых эндпоинта и поддержка популярных форматов

API предлагает простую и логичную структуру. Для получения товаров используйте /api/v1/products в форматах JSON или XML. Чтобы узнать точное количество доступных позиций — обращайтесь к /api/v1/products/count. Для выгрузки активных разделов каталога предназначен /api/v1/categories. Все эндпоинты поддерживают постраничную выдачу, что удобно при работе с большими объёмами данных. Авторизация выполняется через заголовок Authorization: Bearer — это стандартный и безопасный способ передачи токена. Для совместимости со старыми интеграциями оставлена возможность передавать токен через query-параметр, но для production-среды рекомендуется именно Bearer-схема, чтобы ключ не светился в URL и логах.

Безопасность на уровне хранения и аудита запросов

Модуль спроектирован с учётом реальных рисков. Полное значение токена хранится в базе в защищённом виде и показывается администратору только один раз — при создании или перевыпуске. В списках вы видите лишь префикс, что исключает случайную утечку ключа через интерфейс. Журнал API-запросов фиксирует endpoint, HTTP-метод, статус ответа, длительность, IP-адрес и идентификатор пользователя токена. При этом сам токен и исходная query-строка в лог не попадают. Это позволяет отслеживать активность без компрометации учётных данных. Для дополнительного удобства на сайте автоматически создаётся публичная страница /api/ с краткой справкой по всем доступным эндпоинтам.

Кому пригодится: от интернет-магазинов до BI-систем

Решение подходит для B2B-порталов и интернет-магазинов на 1С-Битрикс, которые передают каталог дилерам, партнёрам или франчайзи. Оно востребовано в проектах, где нужно подключить внешний сайт, мобильное приложение, CRM, PIM-систему или BI-отчётность. Особенно полезен модуль, если важно разделять доступ к ценам, остаткам, свойствам и разделам для разных категорий клиентов. Вместо того чтобы создавать несколько копий каталога или писать собственную интеграцию, вы получаете готовый, отлаженный инструмент с поддержкой торговых предложений, цен и остатков. А служебные поля api_version и schema_version в успешных ответах помогут вашим разработчикам быстро ориентироваться в версиях API.