Канонические AI-документы Vesremont
Ниже 15 канонических тематических документов. HTML-зеркала передают те же сведения; выбирайте удобный формат, а не читайте оба подряд. Схемы операций определяет API, текущую цену и остаток — ответ товара, условия магазина — их канонические страницы. Документы обновляются штатным генератором.
Текущая версия: 1.14.31. Ревизия: sha256:5645af5ca9e82c3127c691283c5eec16d7efab8039972ccbbae5ae4b8ec746ce.
Выберите задачу
Не нужно проходить все интерфейсы подряд. Выберите цель, затем подходящий способ обращения и только необходимые права.
- Найти артикул или модель — Совпадение, ID и ссылка на товар; не первый похожий результат.
- Подобрать по категории и характеристикам — Подборка по текущим фасетам; затем проверка каждой карточки.
- Выбрать бренд — Ассортимент нужного бренда, не смешение brand.id и product_id.
- Сравнить цену, наличие и отзывы — Отдельные проверенные факты; отзывы — в reviews.md.
- Прислать готовую ссылку на корзину — Опубликованная /buy/ ссылка или share_url; GET не изменяет личную корзину.
- Изменить личную корзину или избранное — Состояние перечитано после записи; remote — с OAuth, browser — session/CSRF.
- Оформить конкретный заказ — Сводка → отдельное подтверждение → проверенное сохранение; не автоматическая оплата.
- Узнать статус заказа и получать события — Доступ только к разрешённым заказам; webhook проверяется и дедуплицируется.
- Ответить о доставке, оплате, возврате — Ответ по публичному источнику; условия не равны статусу конкретного заказа.
- Прочитать или отправить отзыв/вопрос — Чтение публично; запись через browser с подтверждением и модерацией.
- Подключить SDK, CLI, MCP, A2A или UCP — Выбран один подходящий интерфейс, его schema и минимальные права.
- Обойти сайт или обновить интеграцию — Канонические URL и актуальная версия, не выгрузка личных данных.
Полная карта маршрутов и запасные пути · Выбор разрешения · Бесплатный доступ и квоты · Использование публичного контента. Политика контента не даёт доступа к личной корзине.
Найти товар → прислать ссылку на корзину
Для этой задачи не нужны OAuth, аккаунт, cookies или SDK. Найдите товар по артикулу или названию. В нижнем блоке карточки «Для AI-систем» опубликованы внутренний ID и конкретная ссылка https://vesremont.com/buy/{id}:1; текст доступен в серверном HTML и Markdown. Передайте эту ссылку покупателю; не подставляйте артикул вместо ID и не угадывайте число.
Способы поиска — альтернативы, а не обязательная цепочка: обычный HTML-поиск, Markdown-поиск по артикулу или GET /api/v1/products?q={артикул} с items[].id в JSON. Если ваш инструмент не читает JSON, используйте HTML/Markdown и опубликованную ссылку карточки. Блокировка HTTP-инструмента не означает отсутствия функции сайта.
Для подписанной подборки используйте публичный GET /api/v1/cart-drafts/?product_id={id}&quantity=1 и передайте share_url. Агентский GET не меняет личную корзину. Покупатель открывает ссылку, а сайт переносит товары защищённым POST в его браузерную корзину, повторно проверяя цену и возможность заказа. Заказ не создаётся.
Поиск → Товар и ID → Корзина по ссылке и оформление. Чтение или изменение личной корзины через API — отдельный OAuth-путь; браузерный WebMCP использует session/CSRF. Подтверждение конкретного заказа сохраняется в обоих случаях.
Тематические документы
| Раздел | Markdown | HTML-зеркало |
|---|---|---|
| Public API | api.md | /for_ai/api_ai/ |
| Главная в Markdown | home.md | /for_ai/home_ai/ |
| Навигация по каталогу | catalog.md | /for_ai/catalog_ai/ |
| URL и параметры | url-patterns.md | /for_ai/url-patterns_ai/ |
| Фильтры и диапазоны | filters.md | /for_ai/filters_ai/ |
| Данные карточки товара | products.md | /for_ai/products_ai/ |
| Цена и возможность заказа | availability.md | /for_ai/availability_ai/ |
| Поиск по сайту | search.md | /for_ai/search_ai/ |
| Навигация по брендам | brands.md | /for_ai/brands_ai/ |
| Корзина и оформление | purchase.md | /for_ai/purchase_ai/ |
| Доставка и оплата | delivery.md | /for_ai/delivery_ai/ |
| Отзывы и вопросы | reviews.md | /for_ai/reviews_ai/ |
| Поддерживаемые возможности | capabilities.md | /for_ai/capabilities_ai/ |
| Версии и изменения | changelog.md | /for_ai/changelog_ai/ |
| Sitemap и обнаружение URL | sitemaps.md | /for_ai/sitemaps_ai/ |
Сводные и служебные ресурсы
- /agents/ — единая точка входа в действующие возможности агента.
- /index.md — прямой URL того же Markdown, который опубликован как
/llms/home.md. - /llms.txt — короткий маршрутизатор.
- /llm.txt и /llms.html — совместимые имена тех же поддерживаемых представлений.
- /llms-full.txt — автоматически собранный полный контекст.
- /.well-known/ai.txt — каноническая AI-policy; /.well-known/ai.json — эквивалентный JSON; /ai.txt — совместимый текстовый URL.
- /.well-known/api-catalog — RFC 9727 discovery браузерного и удалённых интерфейсов.
- /llms/api.md — REST/OpenAPI, OAuth, MCP, A2A, UCP, webhooks, SDK и CLI; /auth.md — session/CSRF и OAuth PKCE.
- /.well-known/agent-skills/index.json — Agent Skills Discovery v0.2.0.
- /identity.json и /brand.txt — единая идентичность организации в JSON и тексте.
- /faq-ai.txt, /developer-ai.txt, /robots-ai.txt, /pricing.md — generated compatibility-представления.
- /.well-known/security.txt — RFC 9116 security contact.
- /robots.txt — фактические правила обхода.
- /for_ai/ — человекочитаемый справочник.