API и интеграции

К магазину можно подключить ИИ-ассистента, свою учётную систему, сайт или маркетплейс: искать товары, смотреть цены опта и остатки, узнавать статус заказа и отправлять заявки. Ниже — все способы подключения и короткие инструкции. Открытые способы работают без регистрации; для заявок на заказ нужен ключ партнёра.

A2A — агент магазинаПротокол Agent2Agent: поиск, цены, остатки, статус и заявки на заказ.WebMCP в браузереИнструменты магазина для ИИ-агентов, которые работают прямо на сайте.Товарный фид YMLВесь каталог с ценами и остатками для маркетплейсов и рекламы.Прайс-лист ExcelТаблица с фото, ценами и остатками — обновляется каждую ночь.llms.txtКарта магазина для ИИ-поисковиков и ассистентов.Ключ партнёраКак получить доступ к заявкам на заказ и своим заказам.

A2A — агент магазина

Магазин работает как агент по открытому протоколу Agent2Agent (A2A), версии 1.0 и 0.3, транспорт JSON-RPC. Любой A2A-клиент находит возможности магазина по карточке агента и дальше общается с ним сообщениями — текстом или структурированными данными.

Карточка агента: https://ohanaopt.ru/.well-known/agent-card.json
Адрес для запросов: POST https://api.ohanaopt.ru/a2a
Авторизация: не нужна для открытых навыков; для заявок — Authorization: Bearer ohp_…

Навыки

Навык	Что делает	Доступ
catalog_search	Поиск по каталогу: название, артикул, тип товара. Цены опта и крупного опта, остатки по размерам.	открытый
product_details	Карточка товара по артикулу: размеры, цены, остатки, состав, сертификат.	открытый
wholesale_terms	Условия опта: минимальный заказ, доставка, оплата, возврат, документы для маркетплейсов.	открытый
order_status	Статус заказа: нужны номер заказа и последние 4 цифры телефона покупателя.	открытый
contact_manager	Передать вопрос или заявку менеджеру — ответ придёт на указанный контакт.	открытый
order_request	Заявка на заказ: проверка позиций, остатков и кратности, расчёт цен по уровню опта; dry_run — только расчёт.	ключ партнёра
my_orders	Заказы покупателя, к которому привязан ключ, за 90 дней.	ключ партнёра

Пример: поиск товара текстом

Обычный текст агент понимает сам: артикул откроет карточку, вопрос про доставку — условия, остальное — поиск по каталогу.

curl -s -X POST https://api.ohanaopt.ru/a2a \
  -H 'Content-Type: application/json' -H 'A2A-Version: 1.0' \
  -d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{
        "messageId":"1","role":"ROLE_USER",
        "parts":[{"text":"халат женский велюровый"}]}}}'

Пример: расчёт заявки по ключу партнёра

Чтобы выбрать навык явно, передайте часть data с полем skill и параметрами. С dry_run: true агент только посчитает позиции и цены; без него — передаст заявку менеджеру, и он выставит счёт.

curl -s -X POST https://api.ohanaopt.ru/a2a \
  -H 'Content-Type: application/json' -H 'A2A-Version: 1.0' \
  -H 'Authorization: Bearer ohp_ваш_ключ' \
  -d '{"jsonrpc":"2.0","id":2,"method":"SendMessage","params":{"message":{
        "messageId":"2","role":"ROLE_USER",
        "parts":[{"data":{"skill":"order_request","dry_run":true,
          "items":[{"sku":"15154-54","qty":6},{"article":"11159","size":"48","qty":4}],
          "delivery":"ТК Деловые линии, Казань"}}]}}}'

Ограничения: статус заказа — не больше 10 запросов в час с одного адреса; цены и остатки обновляются из учётной системы каждый час.

WebMCP — инструменты для ИИ-агента в браузере

Сайт публикует свои инструменты по стандарту WebMCP (Model Context Protocol для веб-страниц). Если вы пользуетесь браузером или расширением с ИИ-агентом, поддерживающим WebMCP (например, Chrome 146+), агент на страницах ohanaopt.ru сразу видит инструменты магазина и работает с ними от имени покупателя — в его корзине и с его подтверждением.

search_products — поиск по названию или артикулу, до 10 товаров в наличии с ценами опта;
get_wholesale_terms — минимальный заказ, порог крупного опта, доставка, оплата;
get_cart — содержимое корзины и сколько осталось до порога опта;
add_to_cart — положить товар в корзину (с подтверждением покупателя);
open_page — открыть каталог, товар, корзину или оформление.

Настраивать ничего не нужно: инструменты появляются у агента, когда открыта любая страница магазина.

Товарный фид YML

Каталог в формате YML (Яндекс): каждый размер в наличии — отдельное предложение, модель объединяет размеры через group_id, цена — оптовая (при акции — акционная и старая цена), фото, размер и рост, количество, условие минимального заказа. Обновляется раз в час. Подходит для маркетплейсов, рекламных кабинетов, агрегаторов и загрузки в учётную систему.

https://ohanaopt.ru/feed/yandex.yml

Прайс-лист Excel

Таблица со всеми товарами: фото, артикул, размеры, цены опта и крупного опта, остатки. Обновляется каждую ночь — ссылку можно подключить к своей таблице как постоянный источник.

https://api.ohanaopt.ru/uploads/price/ohana-price.xlsx

llms.txt и карта сайта

Краткая карта магазина для ИИ-поисковиков и ассистентов по стандарту llmstxt.org: разделы каталога, условия, инструменты, статьи блога, контакты.

llms.txt: https://ohanaopt.ru/llms.txt
Карта сайта: https://ohanaopt.ru/sitemap.xml
RSS блога: https://ohanaopt.ru/ru/blog/rss.xml

Ключ партнёра

Ключ нужен для заявок на заказ (order_request) и просмотра своих заказов (my_orders). Его выдаёт менеджер: сообщите название компании, ИНН и e-mail личного кабинета на сайте — к нему привяжем ключ, и заказы будут видны агенту. Ключ передаётся в заголовке Authorization: Bearer ohp_…; храните его как пароль.

Нужен другой способ — обмен с вашей учётной системой, свой формат выгрузки, MCP-сервер для вашего ассистента? Напишите на info@ohanamarket.ru или позвоните +7 958 100-23-45 — обсудим.