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

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

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

Карточка агента

https://ohana-products.ru/.well-known/agent-card.json

Адрес для запросов

POST https://api.ohana-products.ru/a2a

Авторизация

не нужна для открытых навыков; для заявок — Authorization: Bearer ohp_…

Навыки

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

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

curl -s -X POST https://api.ohana-products.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":"напиток JUSSVINA маракуйя"}]}}}'

Пример: навык явно, через data

Чтобы выбрать навык, передайте часть data с полем skill и параметрами. Карточка товара — по адресу товара (handle):

curl -s -X POST https://api.ohana-products.ru/a2a \
  -H 'Content-Type: application/json' -H 'A2A-Version: 1.0' \
  -d '{"jsonrpc":"2.0","id":2,"method":"SendMessage","params":{"message":{
        "messageId":"2","role":"ROLE_USER",
        "parts":[{"data":{"skill":"product_details",
          "id":"napitok-sokosoderzhaschiy-s-dobavleniem-soka-guavy"}}]}}}'

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

Количество — в штуках, кратно коробке (у напитков JUSSVINA 24 банки, в примере по 12 коробок двух вкусов). Минимальный заказ — 35 000 ₽ на всю заявку. С dry_run: true агент только проверит остатки и кратность и посчитает сумму; без него — передаст заявку менеджеру, и он выставит счёт.

curl -s -X POST https://api.ohana-products.ru/a2a \
  -H 'Content-Type: application/json' -H 'A2A-Version: 1.0' \
  -H 'Authorization: Bearer ohp_ваш_ключ' \
  -d '{"jsonrpc":"2.0","id":3,"method":"SendMessage","params":{"message":{
        "messageId":"3","role":"ROLE_USER",
        "parts":[{"data":{"skill":"order_request","dry_run":true,
          "items":[{"url":"https://ohana-products.ru/ru/products/napitok-sokosoderzhaschiy-s-dobavleniem-soka-guavy","qty":288},
                   {"url":"https://ohana-products.ru/ru/products/napitok-sokosoderzhaschiy-s-dobavleniem-soka-marakuyi","qty":288}]}}]}}}'

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

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

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

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

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

Прайс-лист Excel

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

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

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

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

llms.txt

https://ohana-products.ru/llms.txt

Карта сайта

https://ohana-products.ru/sitemap.xml

RSS блога

https://ohana-products.ru/ru/blog/rss.xml

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

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

Нужен другой способ — обмен с вашей учётной системой, товарный фид, свой формат выгрузки? Напишите на info@ohanamarket.ru или позвоните 8 (991) 430-17-30 — обсудим.