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

# Qual versão eu uso?

> A comparação entre a API v1 e a API v2 do SULTS por módulo, base de URL, paginação e gestão de token, para escolher a versão certa

Quem já tem integração no ar hoje está na v1 e continua nela. Quem vai começar agora pelos módulos de Compras, Comunicados, Chamados ou Checklist pode ir direto para a v2. Os demais módulos seguem na v1 enquanto a migração avança.

A v1 não tem data de descontinuação e permanece documentada por inteiro.

## Comparação

| | API v1 | API v2 |
| - | - | - |
| Módulos | Unidades, Chamados, Checklist, Compras, Implantação, Projetos e Expansão | Compras, Comunicados, Chamados e Checklist |
| Base de URL | `https://api.sults.com.br/v1` para Unidades e `https://api.sults.com.br/api/v1` para os demais | `https://api.sults.com.br/api/v2`, com uma base por módulo (`/compras`, `/comunicado`, `/chamados`, `/checklist`) |
| Paginação | `start` (página, a partir de 0) e `limit` (máximo 100) | `page` (página, a partir de 0) |
| Formato da listagem | Envelope com `data`, `start`, `limit`, `totalPage` e `size` | Array direto, sem envelope |
| Gestão de token | Gestão de Tokens **v1** | Gestão de Tokens **v2** |
| Rate limit | 2 requisições por segundo, por IP | 2 requisições por segundo, por IP |

## Devo usar a v1 ou a v2?

**Você já integra o SULTS hoje.** Fique na v1. Nada do que está no ar para de funcionar, e migrar agora só faz sentido se você precisa de um recurso que a v2 tem e a v1 não.

**Você vai começar do zero e o seu caso é Compras.** Comece pela v2. O módulo migrado ganhou endpoints que a v1 nunca teve, como gestão de preço e de estoque em chamadas próprias e o fluxo de etapas de pedido. A v1 de Compras segue funcionando, mas não recebe novas funcionalidades: mix de produtos, etapas de pedido e as próximas novidades do módulo chegam só na v2.

**Você vai começar do zero e o seu caso é Chamados.** Comece pela v2. Além de listar, abrir, consultar a timeline e concluir, que a v1 também faz, a v2 registra interações, adiciona e remove apoios e etiquetas e altera o prazo do chamado.

**Você vai começar do zero e o seu caso é Checklist.** Comece pela v2. Além das avaliações, respostas, check-ins, check-outs e interações de plano de ação, que a v1 também lista, a v2 traz os modelos com seções e questões e lista os planos de ação com filtros de avaliação, questão e situação.

**Você vai começar do zero e precisa de qualquer outro módulo.** Use a v1. Unidades, Implantação, Projetos e Expansão ainda não migraram.

**Você precisa de um módulo da v2 e de outro que ainda está na v1.** Use as duas, cada uma com o seu token. É uma situação comum durante a migração e não há problema em manter as duas integrações lado a lado.

<Note>
  Os tokens não são intercambiáveis. Se a sua integração fala com as duas versões, ela precisa de dois tokens, um de cada gestão. Veja [Autenticação](/geral/autenticacao).
</Note>

## O que muda no seu código

A troca de versão não é só o caminho da URL. Três coisas mudam junto:

O parâmetro de paginação passa de `start` para `page`. A resposta da listagem perde o envelope e vira um array direto, então o laço que hoje lê `resposta.data` passa a ler a resposta inteira. E o token precisa ser gerado na outra gestão.

Os detalhes de cada versão estão em [convenções da v1](/v1/convencoes) e [convenções da v2](/v2/convencoes).

## Próximos passos

<CardGroup cols={2}>
  <Card title="Comece pela v1" icon="layers" color="#202C3A" href="/v1/quickstart">
    Primeira chamada em 5 minutos, listando as unidades da sua rede.
  </Card>

  <Card title="Comece pela v2" icon="rocket" color="#00A3A3" href="/v2/quickstart">
    Primeira chamada em 5 minutos, listando os produtos do catálogo.
  </Card>
</CardGroup>


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