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

# Introdução à API pública do Upcart

> Aprenda a começar com a API do Upcart, adicionar scripts, testar mudanças e personalizar seu carrinho com facilidade.

A **API pública do Upcart** permite personalizar seu carrinho, automatizar fluxos de trabalho e integrar com apps de terceiros — seja você um desenvolvedor ou alguém que está apenas começando.\
Este guia apresenta o básico e ajuda você a começar a criar funcionalidades personalizadas dentro do seu cart drawer.

👉 [Ver a documentação completa da API pública do Upcart](https://rokt.notion.site/upcart-public-api)

***

<div id="overview">
  ## Visão geral
</div>

A API pública é uma coleção de funções JavaScript e listeners de eventos que permitem:

* **Reagir a mudanças no carrinho** — detectar quando itens são adicionados, removidos ou atualizados.
* **Acionar ações** — como abrir ou fechar o carrinho de forma programática.
* **Criar recursos personalizados** — injetar sua própria lógica ou componentes de UI diretamente dentro do cart drawer.

Ela é especialmente útil ao trabalhar na seção **Custom HTML** do editor do Upcart, onde você pode usar essas funções para criar experiências únicas para os compradores.

***

<div id="what-you-need-to-get-started">
  ## O que você precisa para começar
</div>

Antes de usar a API do Upcart, certifique-se de ter:

* **Acesso ao Upcart na sua loja Shopify**\
  Garanta que o Upcart esteja instalado e ativo na sua loja.
* **Um entendimento básico de JavaScript**\
  Muitas personalizações usam trechos pré-escritos, mas conhecer o básico de JavaScript ajuda se você quiser ir além do básico.

***

<div id="adding-your-first-upcart-api-script">
  ## Adicionando seu primeiro script da API do Upcart
</div>

Você pode começar a usar a API diretamente do seu editor do Upcart:

1. Vá para **Upcart Editor → Settings → Custom HTML → Scripts (before load)**

2. Cole seu script — por exemplo:

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

**Nota:** exemplos mais antigos usando `window.upcartOnAddToCart` ainda funcionam, mas estão obsoletos e registram um aviso no console. Use `upcartSubscribeAddedToCart` em todos os novos scripts.

3. Salve suas alterações e depois teste na sua loja:

* Abra as Dev Tools (`F12` ou `Ctrl + Shift + J` no Windows, `Cmd + Option + J` no Mac)
* Adicione um produto ao seu carrinho
* Verifique na aba Console a mensagem:\
  `"You just added [product title] to your cart!"`

🎉 Se você viu a mensagem, seu primeiro script de API está funcionando!

***

<div id="start-customizing-your-cart">
  ## Comece a personalizar seu carrinho
</div>

Agora que você está com tudo configurado, pode usar a API para fazer todo tipo de coisa legal — como abrir automaticamente o carrinho quando itens são adicionados, atualizar widgets personalizados ou enviar eventos de análise.

Para referências completas de funções e exemplos, consulte a **[documentação da API pública do Upcart](https://rokt.notion.site/upcart-public-api)**.

***

<div id="more-resources">
  ## Mais recursos
</div>

* 🧩 **[FAQ da API](/pt/upcart/upcart_api_frequently_asked_questions)** — Dicas de solução de problemas e perguntas comuns
* ⚙️ **[Usos comuns da API do Upcart](/pt/upcart/common_upcart_api_uses)** — Exemplos de código e modelos populares
* 💡 **[Documentos de personalização](/pt/upcart/add_a_mandatory_terms_and_conditions_checkbox_to_your_cart)** — Scripts pré-escritos para ajudar você a começar rápido
* 🛍️ **[Documentação da Cart API do Shopify](https://shopify.dev/docs/api/ajax/reference/cart)** — Saiba como o Shopify lida com os dados do carrinho nos bastidores
* 👩💻 Precisa de personalizações avançadas? Considere contratar um [Shopify Expert](https://www.shopify.com/ca/partners/directory/services/development-and-troubleshooting/custom-apps-integrations) para integrações mais complexas.