Kokhanenko: B2B Catalog API

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 в журнал не записываются.