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

# Autenticação na API v2 do SULTS

> Como gerar o token v2 do SULTS, o fluxo de exibição única e o envio no cabeçalho Authorization

<span className="badge-v2">API v2</span>

Toda chamada aos endpoints v2 é autenticada por um **token** enviado no cabeçalho `Authorization`, gerado na **Gestão de Tokens v2**.

## Gere o seu token v2

1. Acesse `https://suamarca.sults.com.br` com uma conta de **administrador**.
2. No painel inicial, clique em **Segurança** e, no menu lateral, em **API**.
3. Abra **Gestão de Tokens v2** (caminho direto: `/seguranca/api/sults-token/2`).
4. Clique em **Criar Token**, dê um nome e informe o **e-mail de contato do desenvolvedor** (usado pelo SULTS caso precise falar com quem mantém a integração).
5. **Copie o token na hora**: por segurança, ele é exibido **uma única vez**, com os botões Mostrar e Copiar. Depois disso, a tabela mostra apenas uma versão mascarada.

<Warning>
  Perdeu o token? Não há como revê-lo: exclua o registro e crie um novo. E o aviso de sempre, nos dois sentidos: **tokens v1 não funcionam nos endpoints v2**, e vice-versa.
</Warning>

## Faça uma chamada autenticada

```bash theme={"theme":{"light":"github-dark","dark":"github-dark"}}
curl "https://api.sults.com.br/api/v2/compras/product/list?page=0" \
  -H "Authorization: SEU_TOKEN"
```

Repare que o valor do cabeçalho é o **token puro**: a API não usa o esquema `Bearer` (não escreva `Authorization: Bearer SEU_TOKEN`). Nas requisições com corpo (POST e PUT), envie também `Content-Type: application/json;charset=UTF-8`.

## Boas práticas

As mesmas da v1, e valem dobrado com o fluxo de exibição única: guarde o token em **variável de ambiente ou cofre de segredos** no momento da criação, use apenas em código de servidor, crie **um token por integração** (o e-mail de contato ajuda a rastrear), e para rotacionar, crie o novo antes de excluir o antigo.

## O que o token pode fazer

Hoje o token da v2 dá acesso a todos os endpoints da versão. O controle de permissão por token está no roadmap da v2, sem data definida: quando existir, será possível restringir o que cada token acessa.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Referência da API v2" icon="code" href="/v2/api-reference/produtos/listar-produtos">
    Os 45 endpoints da v2, em Compras, Comunicados, Chamados e Checklist, com métodos e URLs.
  </Card>

  <Card title="Qual versão eu uso?" icon="signpost" href="/geral/qual-versao-eu-uso">
    Confira em segundos se a sua integração é v1 ou v2.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.