Авторизация
Забыли пароль?
Сброс пароля
Вернуться к авторизации

API каталога для партнёров производителя: у каждого своя цена, номер находится за 2–3 мс

20 ноября ‘26

Заказчик: Производитель автокомпонентов
Страница кейса/результат: https://we-free.ru/dorabotka-sayta/

Сделали для производителя автокомпонентов API каталога для интернет-магазинов и дистрибьюторов. Каждый партнёр получает только свою цену и свои поля, номер детали находится в любом написании за 2–3 мс, а попытки выкачать базу видны администратору.

Агентство-исполнитель кейса

we-free.ru

we-free.ru — разработка и доработка коммерческих сайтов на 1С-Битрикс и WordPress. Делаем API и обмены для партнёров, ускоряем каталоги и поиск, поддерживаем сайты, сделанные другими подрядчиками. Сначала разбираемся, что на сайте уже работает, потом меняем.

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 для партнёров, ускорение поиска, новые функции на работающем каталоге — мы решаем в рамках доработки сайта.

Агентство-исполнитель кейса

we-free.ru

we-free.ru — разработка и доработка коммерческих сайтов на 1С-Битрикс и WordPress. Делаем API и обмены для партнёров, ускоряем каталоги и поиск, поддерживаем сайты, сделанные другими подрядчиками. Сначала разбираемся, что на сайте уже работает, потом меняем.