Skip to main content
Публичный API Upcart позволяет настраивать корзину, автоматизировать рабочие процессы и интегрироваться со сторонними приложениями — независимо от того, разработчик вы или только начинаете.
Это руководство познакомит вас с основами и поможет начать создавать пользовательскую функциональность внутри вашей выдвижной корзины.
👉 Посмотреть полную документацию публичного API Upcart

Обзор

Публичный API — это набор функций JavaScript и обработчиков событий, которые позволяют:
  • Реагировать на изменения корзины — обнаруживать добавление, удаление или обновление товаров.
  • Запускать действия — например, программно открывать или закрывать корзину.
  • Создавать пользовательские функции — внедрять собственную логику или UI-компоненты непосредственно в выдвижную корзину.
Он особенно полезен при работе в разделе Custom HTML редактора Upcart, где вы можете использовать эти функции для создания уникального опыта покупателей.

Что нужно для начала работы

Прежде чем использовать API Upcart, убедитесь, что у вас есть:
  • Доступ к Upcart в вашем магазине Shopify
    Убедитесь, что Upcart установлен и активен в вашем магазине.
  • Базовое понимание JavaScript
    Многие кастомизации используют готовые фрагменты кода, но знание основ JavaScript пригодится, если вы хотите выйти за рамки базовых возможностей.

Добавление вашего первого скрипта API Upcart

Вы можете начать использовать API прямо в редакторе Upcart:
  1. Перейдите в Upcart Editor → Settings → Custom HTML → Scripts (before load)
  2. Вставьте свой скрипт — например:
Примечание: старые примеры с использованием window.upcartOnAddToCart всё ещё работают, но считаются устаревшими и выводят предупреждение в консоль. Используйте upcartSubscribeAddedToCart для всех новых скриптов.
  1. Сохраните изменения, затем протестируйте их в своём магазине:
  • Откройте инструменты разработчика (F12 или Ctrl + Shift + J в Windows, Cmd + Option + J на Mac)
  • Добавьте товар в корзину
  • Проверьте вкладку Console на наличие сообщения:
    "You just added [product title] to your cart!"
🎉 Если вы видите это сообщение, ваш первый API-скрипт работает!

Начните настраивать корзину

Теперь, когда всё настроено, вы можете использовать API для самых разных интересных вещей — например, автоматически открывать корзину при добавлении товаров, обновлять пользовательские виджеты или отправлять события аналитики. Полный справочник функций и примеры см. в документации публичного API Upcart.

Дополнительные ресурсы