Одна ссылка или скрипт без зависимостей добавляет на ваш сайт кнопку, которая безопасно передаёт товар в редактор Xohlayman.
Без SDK · только HTTPS · 18 местных магазинов
/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Номер карты для переводов, имена гостей, записи о переводах, чужие аккаунты и всё из админки. Токен даёт доступ только к вашему аккаунту, а отозванный токен сразу перестаёт работать. Правки магазина уходят на модерацию: сам магазин опубликовать карточку не может.