Индекс документации: https://vesremont.com/llms.txt
Связь этого раздела с задачей
Задача: Найти бренд и перейти к его ассортименту.
Что нужно на входе: Название бренда, его опубликованный URL или brand.id из товара.
Результат: Проверенный бренд и список его товаров; brand.id не подменяет section_id или product_id.
Другая цель? Карта всех задач и режимов. Права личного доступа — auth.md; это не обязательный шаг для публичного чтения.
Следующий раздел по теме: Навигация по каталогу — просмотреть ассортимент · Фильтры и диапазоны — подобрать характеристики · Данные карточки товара — проверить конкретную модель.
Бренды через API
GET /api/v1/brands?q={text} возвращает бренды по существующему поиску магазина. Бренд товара читается из /api/v1/products/{product_id}; фильтр списка товаров использует его brand.id. ID бренда и ID раздела различны даже при совпадающих названиях. Для browser-навигации используйте возвращённый canonical URL. Параметры и ограничения: Public API.
Точки входа
- Индекс брендов: https://vesremont.com/brand/
- Страница бренда:
/catalog/brand/{brand-code}/
Индекс брендов генерируется из актуальных серверных данных и содержит ссылки на страницы брендов, популярные бренды и алфавитные группы.
Поиск брендов
На /brand/ есть форма GET с name="q", но текущий JavaScript перехватывает её и выполняет POST-поиск подсказок. Серверная страница /brand/ сама не обрабатывает q как полноценную страницу результатов. Поэтому:
- для универсального поиска используйте
/search/?search={brand-name}; - для обхода брендов используйте ссылки индекса
/brand/или brand sitemap; - не объявляйте
/brand/?q=...стабильным серверным API.
Страница бренда
Страница бренда является каталогом: она показывает категории товаров бренда, фасеты, сортировку и пагинацию. Для дальнейшей фильтрации используйте опубликованные ссылки так же, как на обычной категории.
Правила AI-блока на страницах магазина
Эти правила и блок на сайте формируются из одного источника. Числа в фигурных скобках — обозначения, не реальные ID.
Каталог бренда
Вы на странице ассортимента бренда. Бренд не определяет конкретную модель: откройте карточку из листинга и сверьте артикул, характеристики и комплектацию. ID бренда не является product_id. Навигация по брендам.
Как уточнить подборку
Берите значения, диапазоны и ссылки фильтров из текущей страницы. После изменения перечитайте список и выбранные фильтры. Для REST сначала GET /api/v1/catalog/filters?section_id={section_id} либо ?brand_id={brand_id}, затем GET /api/v1/products с тем же контекстом и filters — одним URL-кодированным JSON-объектом по схеме. HTML-сегменты URL не являются REST-параметрами. Фильтры и диапазоны · HTML URL · OpenAPI.
Из листинга в карточку
Откройте ссылку нужного товара. В нижнем блоке карточки «Для AI-систем» указаны внутренний product_id, данные для текстового клиента и готовая ссылка на корзину, если доступно оформление. Не подставляйте артикул, ID бренда/раздела или строки корзины вместо product_id. Сверьте модель, текущую цену и возможность заказа в карточке; совпадение фотографии недостаточно. Правила карточки · Цена и наличие.
Если товар не найден
Публичный поиск без регистрации: GET /api/v1/products?q={артикул}&per_page=5. Числовой items[].id — ID товара. Если клиент не читает JSON, используйте /api/v1/products.md?q={артикул} или /search/?search={артикул}. Сверьте точное совпадение; несколько подходящих вариантов требуют уточнения. Пример Markdown-каталога · Поиск · API.
Передать корзину
Передайте опубликованную в карточке ссылку /buy/{product_id}:{quantity} либо получите share_url через GET /api/v1/cart-drafts/?product_id={product_id}&quantity=1. Вход, cookies, API-ключ и OAuth для подготовки ссылки не нужны. GET корзину не меняет. Когда покупатель откроет ссылку, сайт защищённым POST-запросом перенесёт товар в его корзину и заново проверит текущую цену и наличие. Заказ при этом не оформляется, а доступа к чужой корзине ссылка не даёт. Перенос подборки и оформление.
Личные операции отдельно
Для чтения или изменения личной корзины через REST, MCP, A2A или UCP нужно отдельное разрешение покупателя. Общее разрешение агенту не подтверждает конкретный заказ: его состав и сумму покупатель подтверждает отдельно. Выбрать сценарий · Разработчикам.