> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Введение в публичный API Upcart

> Узнайте, как начать работу с API Upcart, добавлять скрипты, тестировать изменения и легко настраивать корзину.

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

👉 [Посмотреть полную документацию публичного API Upcart](https://rokt.notion.site/upcart-public-api)

***

<div id="overview">
  ## Обзор
</div>

Публичный API — это набор функций JavaScript и обработчиков событий, которые позволяют:

* **Реагировать на изменения корзины** — обнаруживать добавление, удаление или обновление товаров.
* **Запускать действия** — например, программно открывать или закрывать корзину.
* **Создавать пользовательские функции** — внедрять собственную логику или UI-компоненты непосредственно в выдвижную корзину.

Он особенно полезен при работе в разделе **Custom HTML** редактора Upcart, где вы можете использовать эти функции для создания уникального опыта покупателей.

***

<div id="what-you-need-to-get-started">
  ## Что нужно для начала работы
</div>

Прежде чем использовать API Upcart, убедитесь, что у вас есть:

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

***

<div id="adding-your-first-upcart-api-script">
  ## Добавление вашего первого скрипта API Upcart
</div>

Вы можете начать использовать API прямо в редакторе Upcart:

1. Перейдите в **Upcart Editor → Settings → Custom HTML → Scripts (before load)**

2. Вставьте свой скрипт — например:

```
<script>
  window.upcartSubscribeAddedToCart(function(event) {
    console.log("You just added " + event.item.title + " to your cart!");
  });
</script>
```

**Примечание:** старые примеры с использованием `window.upcartOnAddToCart` всё ещё работают, но считаются устаревшими и выводят предупреждение в консоль. Используйте `upcartSubscribeAddedToCart` для всех новых скриптов.

3. Сохраните изменения, затем протестируйте их в своём магазине:

* Откройте инструменты разработчика (`F12` или `Ctrl + Shift + J` в Windows, `Cmd + Option + J` на Mac)
* Добавьте товар в корзину
* Проверьте вкладку Console на наличие сообщения:\
  `"You just added [product title] to your cart!"`

🎉 Если вы видите это сообщение, ваш первый API-скрипт работает!

***

<div id="start-customizing-your-cart">
  ## Начните настраивать корзину
</div>

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

Полный справочник функций и примеры см. в **[документации публичного API Upcart](https://rokt.notion.site/upcart-public-api)**.

***

<div id="more-resources">
  ## Дополнительные ресурсы
</div>

* 🧩 **[FAQ по API](/ru/upcart/upcart_api_frequently_asked_questions)** — советы по устранению неполадок и частые вопросы
* ⚙️ **[Распространённые сценарии использования API Upcart](/ru/upcart/common_upcart_api_uses)** — популярные примеры кода и шаблоны
* 💡 **[Документация по кастомизации](/ru/upcart/add_a_mandatory_terms_and_conditions_checkbox_to_your_cart)** — готовые скрипты, которые помогут быстро начать
* 🛍️ **[Документация Shopify по Cart API](https://shopify.dev/docs/api/ajax/reference/cart)** — узнайте, как Shopify обрабатывает данные корзины «за кулисами»
* 👩💻 Нужны сложные кастомизации? Рассмотрите возможность нанять [эксперта Shopify](https://www.shopify.com/ca/partners/directory/services/development-and-troubleshooting/custom-apps-integrations) для более сложных интеграций.