Авторизация
Сброс пароля
API каталога для партнёров производителя: у каждого своя цена, номер находится за 2–3 мс
Заказчик: Производитель автокомпонентов
Страница кейса/результат: https://we-free.ru/dorabotka-sayta/

Сделали для производителя автокомпонентов API каталога для интернет-магазинов и дистрибьюторов. Каждый партнёр получает только свою цену и свои поля, номер детали находится в любом написании за 2–3 мс, а попытки выкачать базу видны администратору.
1. Вводная задача от заказчика, проблематика, цели
Заказчик — производитель автокомпонентов. В каталоге около тысячи артикулов. Сайт работает на 1С-Битрикс: подбор по марке и модели автомобиля, поиск по VIN и по оригинальным номерам, точки продаж партнёров на карте.
Клиенты производителя — интернет-магазины и дистрибьюторы. Им нужны данные из каталога производителя в их собственных системах: кроссы на оригинальные номера, характеристики, цены и наличие. Получать их партнёры хотели программно, через API.
Задачу «отдать каталог наружу» мы разложили на четыре требования заказчика:
- партнёр присылает номер детали в том виде, в каком он записан у него, и API находит нужный артикул;
- каждый партнёр получает только свою цену и свой набор полей;
- каталог нельзя незаметно выкачать целиком;
- сотрудники заказчика по-прежнему правят данные в обычной админке Битрикса.
Сразу начать с API было нельзя. На сайте не было места для части нужных данных: кроссов на аналоги, цен по типам, остатков, статусов артикулов. Поэтому работа началась с хранилища.
2. Описание реализации кейса и творческого пути по поиску оптимального решения
Сначала данные
Новые таблицы мы сделали highload-блоками Битрикса. Так заказчик видит и правит данные в админке, отдельный интерфейс писать не нужно.
Несколько решений в устройстве таблиц потом себя оправдали:
- Цены хранятся построчно: артикул, тип цены, цена. Не колонками. Новый тип цены добавляется без правки схемы и кода.
- Статус артикула — в отдельной таблице. В таблице применимости у одного артикула бывает до полусотни строк, и статус в каждой из них пришлось бы держать одинаковым.
- Уникальность обеспечивает сама база. Двух цен одного типа у артикула не может быть, это задано уникальным ключом. Поэтому обновление делается одним запросом «вставить или обновить», без опасного «удалить всё и залить заново».
- Типы столбцов приведены вручную. Битрикс создаёт строковые поля как text, а на такое поле нельзя повесить уникальность.
Одну ошибку поймали до массовой загрузки. Новые таблицы создавались в кодировке по умолчанию, и кириллица превращалась в «????». Мы заметили это на 27 записях справочника, до того как в таблицы пошли тысячи строк характеристик. Иначе её заметили бы только после импорта.
Все миграции — консольные скрипты. По умолчанию скрипт только показывает план и ничего не меняет, запись включается отдельным флагом. Повторный запуск добавляет только то, чего не хватает.
Одна точка входа для всех операций
У API один адрес, тип операции передаётся в теле запроса. Новый метод не требует нового адреса и не ломает интеграции партнёров, которые уже подключились. Формат заложили с запасом под модуль заказов: техническое задание на него заказчик прислал позже.
Цена и поля привязаны к ключу партнёра
Если тип цены выбирается параметром запроса, партнёр может подставить чужой. Поэтому у каждого ключа жёстко задан один разрешённый тип цены и свой набор полей. Одному партнёру API отдаёт только кроссы, другому — данные вместе с ценами. Чужую цену не получить ни другим параметром, ни изменённым адресом.
Это проверяет отдельный автотест. Он отправляет обычный запрос и запрос с попыткой подменить тип цены, затем сравнивает ответы. Если подмена что-то изменила, тест падает.
Поиск по номеру в любом написании
В системах партнёров один и тот же номер записан по-разному: с пробелами, через дефис, в другом регистре. Чтобы API находил артикул в любом случае, номер приводится к единому виду.
В первой версии это делалось прямо в поисковом запросе. База обрабатывала всю таблицу кроссов при каждом обращении и не могла использовать индекс: 64 мс на операцию. Мы вынесли нормализованный номер в отдельный вычисляемый столбец и построили по нему индекс. Теперь поиск идёт по готовому полю: 2–3 мс.
Остальные выборки тоже сделаны пакетными. На любое число артикулов в ответе уходит постоянное число запросов к базе, а не по запросу на позицию. API работает с таблицами напрямую и не загружает ядро Битрикса. Данные при этом общие: партнёры и админка читают одни и те же таблицы.
Как заметить, что каталог выкачивают
Лимит частоты не показывает, что делает клиент: можно уложиться в лимит и методично пройти весь каталог. Поэтому сигналов несколько:
- лимиты обращений в секунду и в сутки; счётчики в базе обновляются атомарно, и одновременные запросы не теряются;
- журнал всех обращений;
- раз в час отдельный процесс смотрит долю промахов, долю уникальных номеров и ровные последовательности. Артикулы в каталоге идут с шагом 10, и цепочка запросов с таким шагом — это перебор, а не работа.
Находки приходят администратору письмом. Ключ автоматически не блокируется, так решил заказчик: система даёт сигнал, решение принимает человек.
Витрина сайта
Новые данные пригодились и самому сайту. Рекомендованная розничная цена теперь выводится в карточке товара, в листингах и в результатах поиска. Товары, выведенные из ассортимента, помечены, цены у них нет. Логика собрана в одном месте, а не повторена в четырёх шаблонах. Данные читаются пакетно: два запроса на страницу листинга вместо двух на каждую карточку.
Приёмка одной командой
Приёмочный прогон — 33 проверки: авторизация, форматы ошибок, карточка, поиск в разных написаниях номера, пакетный запрос со всеми состояниями, права на цены и поля, срабатывание лимита. Проверки только читают данные. Поэтому их можно запускать на рабочем сайте после каждой выкладки.
Стек: PHP 8.2, 1С-Битрикс (highload-блоки, компоненты, события), MySQL, REST/JSON, cron, приёмочные тесты на curl.

Номер приводится к единому виду один раз и хранится в вычисляемом столбце с индексом
3. Результаты сотрудничества
- Поиск по номеру: 64 мс → 2–3 мс.
- Карточка товара в API: 2–5 мс. Пакет из 200 позиций: около 6 мс.
- Каждый партнёр получает только свою цену и свои поля. Попытку подмены ловит автотест.
- Выкачивание каталога отслеживается по нескольким признакам, а не только по частоте запросов.
- Данные о кроссах, ценах, остатках и статусах хранятся в таблицах, которые заказчик правит в обычной админке.
- Покупатели на сайте видят рекомендованную цену, а товары, выведенные из ассортимента, помечены.
- 33 приёмочные проверки запускаются одной командой и безопасны для рабочего сайта.
Все цифры — время серверных операций, а не скорость загрузки страницы у пользователя. Реализованная часть передана заказчику на приёмку. Влияние на продажи в проекте не измерялось.

4. Заключение
Открыть каталог партнёрам — это не «сделать выгрузку». Владельцу каталога важно, чтобы партнёр быстро находил деталь по своему номеру, видел только свою цену и не мог незаметно забрать всю базу. А сотрудники должны работать с данными как раньше.
Каждое из этих требований решается отдельно, и проверять их тоже нужно отдельно. Поэтому приёмку мы делаем прогоном проверок, который можно повторить после любой выкладки.
Такие задачи — API для партнёров, ускорение поиска, новые функции на работающем каталоге — мы решаем в рамках доработки сайта.



