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

​
개요

Public API는 다음을 가능하게 하는 JavaScript 함수와 이벤트 리스너의 모음이에요:
  • 장바구니 변경에 반응하기 — 상품이 추가, 제거 또는 업데이트되는 시점을 감지해요.
  • 작업 트리거하기 — 프로그래밍 방식으로 장바구니를 열거나 닫는 등의 작업이에요.
  • 커스텀 기능 만들기 — 장바구니 드로어 안에 직접 자신만의 로직이나 UI 컴포넌트를 삽입해요.
특히 Upcart 에디터의 Custom HTML 섹션에서 작업할 때 유용하며, 이 함수들을 사용해 쇼핑객을 위한 독특한 경험을 만들 수 있어요.

​
시작하는 데 필요한 것

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

​
첫 번째 Upcart API 스크립트 추가하기

Upcart 에디터에서 바로 API 사용을 시작할 수 있어요:
  1. Upcart Editor → Settings → Custom HTML → Scripts (before load) 로 이동하세요
  2. 스크립트를 붙여넣으세요 — 예를 들어:
참고: window.upcartOnAddToCart를 사용하는 오래된 예시는 여전히 작동하지만 더 이상 사용되지 않으며(deprecated) 콘솔 경고를 기록해요. 모든 새 스크립트에는 upcartSubscribeAddedToCart를 사용하세요.
  1. 변경 사항을 저장한 후 스토어에서 테스트하세요:
  • 개발자 도구를 여세요 (Windows에서 F12 또는 Ctrl + Shift + J, Mac에서 Cmd + Option + J)
  • 장바구니에 제품을 추가하세요
  • Console 탭에서 다음 메시지를 확인하세요:
    "You just added [product title] to your cart!"
🎉 이 메시지가 보이면 첫 번째 API 스크립트가 작동하는 거예요!

​
장바구니 커스터마이징 시작하기

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

​
추가 리소스