> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nemu.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Como integrar com a API da Nemu?

A API da Nemu permite que você envie eventos de vendas para o dashboard em tempo real, expandindo as funcionalidades do seu aplicativo.

## Autenticação

Inclua o token do dashboard no header `Authorization` da sua requisição.

### Gerando o Token do Usuário

1. Na Nemu, acesse **Configurações** > **API Nemu**.

<img src="https://mintcdn.com/nemu/v7js4A8miNuFwGe1/assets/pages/api/token/1.png?fit=max&auto=format&n=v7js4A8miNuFwGe1&q=85&s=40a013cc22ba4ffa207045787ab194f0" alt="" width="1716" height="1286" data-path="assets/pages/api/token/1.png" />

2. Clique em **Gerar token**.

<img src="https://mintcdn.com/nemu/v7js4A8miNuFwGe1/assets/pages/api/token/2.png?fit=max&auto=format&n=v7js4A8miNuFwGe1&q=85&s=f69d570451712a9eae6b5d2d532edf05" alt="" width="470" height="375" data-path="assets/pages/api/token/2.png" />

3. Copie o token exibido.

<img src="https://mintcdn.com/nemu/v7js4A8miNuFwGe1/assets/pages/api/token/3.png?fit=max&auto=format&n=v7js4A8miNuFwGe1&q=85&s=b12d479f9b5dfd9919353a5c6d50d7ae" alt="" width="472" height="269" data-path="assets/pages/api/token/3.png" />

<Tip>
  Mantenha o token em segurança. Ele é único e deve ser usado apenas em requisições autorizadas.
</Tip>

## Recuperando UTMs para Integração

Para enviar dados de vendas com informações de rastreamento (UTMs), você deve recuperar essas informações de uma das três fontes disponíveis na seguinte ordem de prioridade:

### Fontes de UTMs Disponíveis

1. **Variável Global** (Prioridade 1): `window.trackingNemu.nemuUtms`

   * Retorna um objeto `URLSearchParams` com as UTMs
   * Disponível quando o pixel da Nemu está carregado na página

2. **Cookie** (Prioridade 2): `nemuUtmsTrack`

   * Cookie contendo as informações de UTMs em formato de query string

3. **LocalStorage** (Prioridade 3): `nemu:utmsTrack`
   * Armazenamento local com as UTMs em formato de query string

### Implementação Recomendada

```javascript theme={null}
// Função auxiliar para obter cookies
function getCookie(name) {
  const value = `; ${document.cookie}`;
  const parts = value.split(`; ${name}=`);
  if (parts.length === 2) return parts.pop().split(";").shift();
}

// Recuperação de UTMs com fallback
const utms =
  window.trackingNemu?.nemuUtms?.toString() ||
  getCookie("nemuUtmsTrack") ||
  localStorage.getItem("nemu:utmsTrack");
```

### Estratégia de Fallback

A implementação deve seguir a ordem de prioridade, tentando primeiro a variável global, depois o cookie e por último o localStorage. Isso garante que as UTMs sejam capturadas independentemente de como o usuário chegou à página.

<Tip>
  A variável global `window.trackingNemu.nemuUtms` só estará disponível se o
  pixel da Nemu estiver carregado na página. Use o operador de encadeamento
  opcional (`?`) para evitar erros.
</Tip>

## Enviando Dados de Vendas

A API oferece duas rotas principais para criar e atualizar pedidos:

* `POST /sales` para criar vendas
* `PUT /sales/:transactionId` para atualizar vendas

<Tip>
  Certifique-se de incluir o header `Authorization` com seu token de API em
  todas as requisições.
</Tip>