Подключение AI Storefront SDK

Техническая страница для разработчика сайта, интегратора или LLM-агента: script tag, публичный backend, widget site key, checkout URL, MCP endpoint и параметры отображения.

Минимальный script tag

Коммерческий сценарий запускается через SDK. На сайте хранится публичный ключ, backend проверяет домен, а токены пользователя не передаются через URL.

Рекомендуемый script tag
<script
  src="https://sdk.doms.rest/widget/sdk/doms-ai-storefront-widget.js"
  data-site-key="pub_restaurant_site_key"
  data-api-base="https://sdk.doms.rest"
  data-checkout-auth-mode="doms"
  data-checkout-target="iframe"
  data-layout="panel"
  data-default-city="Москва"
  data-checkout-url="https://restaurant.doms.rest/{sellerId}/cart?cartId={cartId}&storeId={storeId}"
  async>
</script>

Контракт интеграции

Сайт подключает публичный SDK, а рабочая привязка к ресторану хранится в DOMS: seller, store, checkout URL, режим отображения и список разрешенных origins.

Безопасность сайта

SDK делает bootstrap по siteKey, а backend проверяет реальный Origin по allowlist.

Гость без логина

Меню, вопросы и корзина работают до авторизации. Вход нужен только в сценарии оформления.

Передача корзины

AI backend готовит buyer cart и передает пользователя в checkout с готовым cartId.

MCP для агентов

LLM-агент может получить snippets, schema, события и правила интеграции.

MCP и настройки

MCP нужен агентам и внутренним интеграторам, чтобы получать актуальные правила подключения без копирования устаревших snippets вручную.

Hosted MCP endpoint
{
  "mcpServers": {
    "doms-storefront-widget": {
      "type": "streamable-http",
      "url": "https://sdk.doms.rest/mcp"
    }
  }
}

Что можно настраивать

  • 1data-layout: panel или overlay под сценарий сайта.
  • 2data-position и mobile placeholder для точки входа.
  • 3data-locale, default city и checkout target.
  • 4Quick-start сценарии управляются в DOMS, а не хардкодятся в HTML.
Скопировано