> ## 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?

> Программный интерфейс приложений (Application Programming Interface) служит посредником, который позволяет различным программным приложениям взаимодействовать и обмениваться данными.

<div id="a-simple-analogy-a-restaurant-a-waiter">
  # Простая аналогия: ресторан и официант
</div>

Представьте, что вы ужинаете в ресторане.

1. **Вы, клиент**, просматриваете меню и заказываете чизбургер с картофелем фри (это похоже на запрос данных корзины).
2. **Официант (API)** принимает ваш заказ и передаёт его на кухню (точно так же API получает ваш запрос и отправляет его на сервер).
3. **Кухня (сервер)** готовит ваше блюдо, обрабатывая заказ и собирая необходимые ингредиенты (примерно так же сервер получает или изменяет данные корзины).
4. **Официант (API)** затем приносит блюдо к вашему столу, позволяя вам насладиться едой (так же, как API возвращает запрошенные данные и обновляет вашу корзину).

Эта аналогия даёт простой способ понять, как работают API, особенно если вы с ними ещё не знакомы. Используя API Upcart, думайте об этом как о заказе в ресторане: решите, что должна делать корзина, а остальное сделает API.

Узнайте, как API Upcart может усилить ваш магазин, изучив нашу [документацию по API](/ru/upcart/introduction_to_upcarts_public_api).

***

<div id="how-this-relates-to-upcarts-api">
  # Как это связано с API Upcart
</div>

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

Например, если вы хотите проверить, правильно ли работает API Upcart, вы можете запустить простой скрипт в своём пользовательском HTML, который выводит сообщение при каждом открытии корзины:

```
<script>  
  window.upcartSubscribeCartOpened(() => {  
    console.log("UpCart API Test - The cart has been opened!");  
  });  
</script>
```

<div id="verifying-if-its-working">
  ## Проверка работоспособности
</div>

1. Откройте свой магазин и перейдите в **Upcart Settings → Custom HTML**, чтобы добавить скрипт.
2. Сохраните изменения и обновите страницу магазина.
3. Откройте консоль браузера (**F12** или **Ctrl + Shift + J** в Windows, либо **Cmd + Option + J** на Mac).
4. Откройте корзину Upcart — в консоли должно появиться подтверждающее сообщение:

```
Upcart API Test - The cart has been opened!
```

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/api-custom-html-test-script.png?fit=max&auto=format&n=uxKAdY-e0h16xa48&q=85&s=5df59c4ceee2ee520c39b5dd861c46ec" alt="Тестовый скрипт в Custom HTML Upcart, выводящий в консоль браузера сообщение об открытии корзины" width="1472" height="1086" data-path="images/upcart/api-custom-html-test-script.png" />

***

<div id="want-to-learn-more-about-apis">
  ## Хотите узнать больше об API?
</div>

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

**Изучение API и JavaScript для начинающих:**

* [W3Schools: основы JavaScript](https://www.w3schools.com/js/) — изучите базовые скрипты для работы с API Upcart
* [MDN Web Docs: API для начинающих](https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Client-side_web_APIs) — поймите, как API работают в интернет-магазинах
* Документация для разработчиков Shopify — [Shopify AJAX API](https://shopify.dev/docs/api/ajax) (полезно продавцам, интегрирующим Upcart с корзиной Shopify)

API Upcart бесшовно работает без внешних инструментов вроде Postman — вы можете использовать его прямо в настройках Custom HTML Upcart или в коде вашей темы Shopify

***

<div id="need-assistance">
  ## Нужна помощь?
</div>

Если вы новичок в API — не беспокойтесь! Вам не нужно писать JavaScript с нуля: просто скопируйте и вставьте готовые скрипты в настройки Custom HTML Upcart, чтобы настроить корзину за считанные минуты.

Не знаете, с чего начать? Обратитесь к [эксперту Shopify](https://www.shopify.com/partners/directory) или изучите нашу [документацию по API](/ru/upcart/introduction_to_upcarts_public_api).

***