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

# Introducción a la API pública de Upcart

> Aprende cómo empezar con la API de Upcart, agregar scripts, probar cambios y personalizar tu carrito con facilidad.

La **API pública de Upcart** te permite personalizar tu carrito, automatizar flujos de trabajo e integrarte con apps de terceros, ya seas desarrollador o estés apenas comenzando.\
Esta guía te mostrará lo básico y te ayudará a empezar a crear funcionalidades personalizadas dentro de tu carrito deslizante.

👉 [Ver la documentación completa de la API pública de Upcart](https://rokt.notion.site/upcart-public-api)

***

<div id="overview">
  ## Descripción general
</div>

La API pública es una colección de funciones de JavaScript y escuchadores de eventos que te permiten:

* **Reaccionar a los cambios del carrito** — detectar cuando se agregan, eliminan o actualizan artículos.
* **Activar acciones** — como abrir o cerrar el carrito de forma programática.
* **Crear funciones personalizadas** — inyectar tu propia lógica o componentes de UI directamente dentro del carrito deslizante.

Es especialmente útil cuando trabajas en la sección **Custom HTML** del editor de Upcart, donde puedes usar estas funciones para crear experiencias únicas para los compradores.

***

<div id="what-you-need-to-get-started">
  ## Lo que necesitas para empezar
</div>

Antes de usar la API de Upcart, asegúrate de tener:

* **Acceso a Upcart en tu tienda Shopify**\
  Asegúrate de que Upcart esté instalado y activo en tu tienda.
* **Un conocimiento básico de JavaScript**\
  Muchas personalizaciones usan fragmentos ya escritos, pero saber JavaScript básico te ayuda si quieres ir más allá de lo básico.

***

<div id="adding-your-first-upcart-api-script">
  ## Agrega tu primer script de la API de Upcart
</div>

Puedes empezar a usar la API directamente desde tu editor de Upcart:

1. Ve a **Upcart Editor → Settings → Custom HTML → Scripts (before load)**

2. Pega tu script — por ejemplo:

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

**Nota:** Los ejemplos antiguos que usan `window.upcartOnAddToCart` siguen funcionando, pero están obsoletos y registran una advertencia en la consola. Usa `upcartSubscribeAddedToCart` para todos los scripts nuevos.

3. Guarda tus cambios y luego pruébalo en tu tienda:

* Abre las herramientas de desarrollador (`F12` o `Ctrl + Shift + J` en Windows, `Cmd + Option + J` en Mac)
* Agrega un producto a tu carrito
* Revisa la pestaña Console en busca del mensaje:\
  `"You just added [product title] to your cart!"`

🎉 Si ves el mensaje, ¡tu primer script de la API está funcionando!

***

<div id="start-customizing-your-cart">
  ## Empieza a personalizar tu carrito
</div>

Ahora que ya estás configurado, puedes usar la API para hacer todo tipo de cosas geniales — como abrir automáticamente el carrito cuando se agregan artículos, actualizar widgets personalizados o enviar eventos de analítica.

Para referencias completas de funciones y ejemplos, consulta la **[documentación de la API pública de Upcart](https://rokt.notion.site/upcart-public-api)**.

***

<div id="more-resources">
  ## Más recursos
</div>

* 🧩 **[Preguntas frecuentes de la API](/es/upcart/upcart_api_frequently_asked_questions)** — Consejos de solución de problemas y preguntas comunes
* ⚙️ **[Usos comunes de la API de Upcart](/es/upcart/common_upcart_api_uses)** — Ejemplos de código y plantillas populares
* 💡 **[Documentación de personalización](/es/upcart/add_a_mandatory_terms_and_conditions_checkbox_to_your_cart)** — Scripts ya escritos para ayudarte a empezar rápido
* 🛍️ **[Documentación de la Cart API de Shopify](https://shopify.dev/docs/api/ajax/reference/cart)** — Aprende cómo Shopify maneja los datos del carrito tras bambalinas
* 👩💻 ¿Necesitas personalizaciones avanzadas? Considera contratar a un [Shopify Expert](https://www.shopify.com/ca/partners/directory/services/development-and-troubleshooting/custom-apps-integrations) para integraciones más complejas.