Одна ссылка или скрипт без зависимостей добавляет на ваш сайт кнопку, которая безопасно передаёт товар в редактор Xohlayman.
/add307Скрипт не читает корзину, cookies или данные покупателя.
Кнопку ниже монтирует тот же публичный файл, который вы подключаете на своём сайте.
shop.example/products/headphones•••Лёгкие наушники для музыки, работы и долгих прогулок.
620 000 so‘mОба варианта ведут через одинаковый безопасный контракт /add.
Добавьте data-атрибуты рядом с вашей кнопкой покупки и один асинхронный скрипт на страницу.
<div
data-xohlayman-button
data-title="Sony WH-CH520"
data-url="https://shop.example/products/sony-wh-ch520"
data-image="https://shop.example/images/sony-wh-ch520.jpg"
data-price="620000"
data-store="My Store"
></div>
<script async src="https://xohlayman.uz/xohlayman-button.js"></script>Сформируйте URL на сервере или прямо в шаблоне карточки товара.
<a href="https://xohlayman.uz/add?url=https%3A%2F%2Fshop.example%2Fproducts%2Fsony-wh-ch520&title=Sony%20WH-CH520&price=620000&store=My%20Store">
Add to Xohlayman
</a>Скрипт сам замечает новые карточки. Публичный метод полезен, когда ваш фреймворк переиспользует существующий узел.
const mount = document.createElement('div');
mount.dataset.xohlaymanButton = '';
mount.dataset.title = product.name;
mount.dataset.url = product.canonicalUrl;
mount.dataset.price = String(product.priceUzs);
document.querySelector('.buy-actions').append(mount);
window.XohlaymanButton?.mount(mount);Ни один параметр не даёт права сохранить подарок автоматически. Неизвестные и небезопасные значения отбрасываются.
urldata-urlКаноническая ссылка на товар. Фрагмент #… удаляется; логины, пароли, порты и HTTP-ссылки не принимаются.
titledata-titleНазвание, которое попадёт в редактор желания. Управляющие символы удаляются, повторные пробелы схлопываются.
imagedata-imageПубличное изображение товара. Браузер загрузит его только после явного подтверждения пользователя в редакторе.
pricedata-priceЦена без пробелов, валютного знака и десятичной части: например, 620000. Допустимы значения до 999 999 999 999.
storedata-storeОтображаемое название магазина или продавца.
kinddata-kindПредлагаемый тип: обычный подарок или общий сбор. Пользователь сможет изменить выбор перед сохранением.
prioritydata-priorityПредлагаемый приоритет желания. Неизвестные значения игнорируются.
Из известных магазинов Xohlayman либо читает публичные метаданные, либо сохраняет ссылку и открывает редактируемую карточку.
Пробуем получить название, изображение и цену.
Антибот не мешает добавить желание вручную.
/add принимает только перечисленные поля, HTTPS-ссылки без credentials и всегда перенаправляет на тот же origin в /app. Произвольный redirect передать нельзя. Если сайт использует nonce в style-src, укажите тот же nonce у подключаемого скрипта — виджет перенесёт его на свои стили.
Подключите Xohlayman как MCP-сервер — и списком можно управлять прямо в разговоре: «что ещё нужно Малике на свадьбу», «добавь кофеварку за 890 000». Транспорт — JSON-RPC 2.0 по HTTP, отдельный SDK не нужен.
https://xohlayman.uz/api/mcpПоиск идей в подборке, чтение открытого списка по коду ссылки, публичный профиль, проверка поддержки магазина. Ровно то, что и так видит любой человек со ссылкой.
search_gift_ideas, get_wishlist, get_profile, check_store_support, list_supported_storesТокен создаётся в настройках профиля (или в кабинете магазина) и передаётся заголовком Authorization: Bearer <токен>. Cookie сервер не читает вообще: у эндпойнта нет «попутных» прав, которые могла бы позаимствовать чужая страница.
list_my_wishlists, get_my_wishlist, add_wish, update_wish, remove_wish, create_wishlist, update_wishlist, list_my_exchanges, get_my_assignmentlist_my_exchanges — Обмены подарками, в которых вы участвуете или которые организовали: статус, бюджет, дата, ссылка.
get_my_assignment — Кому вы дарите после жеребьёвки — и его список желаний. Только чтение.
list_my_offerings, save_offering, archive_offering, get_my_statsНомер карты для переводов, имена гостей, записи о переводах, чужие аккаунты и всё из админки. Токен даёт доступ только к своему аккаунту, отзывается в один клик и перестаёт работать сразу. Правки магазина уходят на модерацию — опубликовать карточку сам магазин не может.