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

# Upcart 공개 API 소개

> Upcart의 API를 시작하고, 스크립트를 추가하고, 변경 사항을 테스트하고, 장바구니를 쉽게 커스터마이징하는 방법을 알아보세요.

**Upcart Public API**를 사용하면 개발자든 이제 막 시작하는 분이든 장바구니를 커스터마이징하고, 워크플로를 자동화하고, 서드파티 앱과 연동할 수 있어요.\
이 가이드에서는 기본 사항을 안내하고 장바구니 드로어 안에서 커스텀 기능을 만들기 시작하도록 도와드려요.

👉 [전체 Upcart Public API 문서 보기](https://rokt.notion.site/upcart-public-api)

***

<div id="overview">
  ## 개요
</div>

Public API는 다음을 가능하게 하는 JavaScript 함수와 이벤트 리스너의 모음이에요:

* **장바구니 변경에 반응하기** — 상품이 추가, 제거 또는 업데이트되는 시점을 감지해요.
* **작업 트리거하기** — 프로그래밍 방식으로 장바구니를 열거나 닫는 등의 작업이에요.
* **커스텀 기능 만들기** — 장바구니 드로어 안에 직접 자신만의 로직이나 UI 컴포넌트를 삽입해요.

특히 Upcart 에디터의 **Custom HTML** 섹션에서 작업할 때 유용하며, 이 함수들을 사용해 쇼핑객을 위한 독특한 경험을 만들 수 있어요.

***

<div id="what-you-need-to-get-started">
  ## 시작하는 데 필요한 것
</div>

Upcart의 API를 사용하기 전에 다음을 갖추었는지 확인하세요:

* **Shopify 스토어의 Upcart 접근 권한**\
  Upcart가 스토어에 설치되어 활성 상태인지 확인하세요.
* **JavaScript에 대한 기본 이해**\
  많은 커스터마이징이 미리 작성된 스니펫을 사용하지만, 기본 이상의 작업을 하고 싶다면 기초 JavaScript 지식이 도움이 돼요.

***

<div id="adding-your-first-upcart-api-script">
  ## 첫 번째 Upcart API 스크립트 추가하기
</div>

Upcart 에디터에서 바로 API 사용을 시작할 수 있어요:

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`를 사용하는 오래된 예시는 여전히 작동하지만 더 이상 사용되지 않으며(deprecated) 콘솔 경고를 기록해요. 모든 새 스크립트에는 `upcartSubscribeAddedToCart`를 사용하세요.

3. 변경 사항을 저장한 후 스토어에서 테스트하세요:

* 개발자 도구를 여세요 (Windows에서 `F12` 또는 `Ctrl + Shift + J`, Mac에서 `Cmd + Option + J`)
* 장바구니에 제품을 추가하세요
* Console 탭에서 다음 메시지를 확인하세요:\
  `"You just added [product title] to your cart!"`

🎉 이 메시지가 보이면 첫 번째 API 스크립트가 작동하는 거예요!

***

<div id="start-customizing-your-cart">
  ## 장바구니 커스터마이징 시작하기
</div>

이제 설정이 완료되었으니, API를 사용해 상품이 추가될 때 장바구니를 자동으로 열거나, 커스텀 위젯을 업데이트하거나, 분석 이벤트를 전송하는 등 다양한 멋진 작업을 할 수 있어요.

전체 함수 레퍼런스와 예시는 **[Upcart Public API 문서](https://rokt.notion.site/upcart-public-api)** 를 확인하세요.

***

<div id="more-resources">
  ## 추가 리소스
</div>

* 🧩 **[API FAQ](/ko/upcart/upcart_api_frequently_asked_questions)** — 문제 해결 팁과 자주 묻는 질문
* ⚙️ **[Upcart API의 일반적인 사용 사례](/ko/upcart/common_upcart_api_uses)** — 인기 있는 코드 예시와 템플릿
* 💡 **[커스터마이징 문서](/ko/upcart/add_a_mandatory_terms_and_conditions_checkbox_to_your_cart)** — 빠르게 시작할 수 있도록 미리 작성된 스크립트
* 🛍️ **[Shopify의 Cart API 문서](https://shopify.dev/docs/api/ajax/reference/cart)** — Shopify가 내부적으로 장바구니 데이터를 처리하는 방식 알아보기
* 👩💻 고급 커스터마이징이 필요하신가요? 더 복잡한 연동은 [Shopify Expert](https://www.shopify.com/ca/partners/directory/services/development-and-troubleshooting/custom-apps-integrations) 고용을 고려해 보세요.