Comparação
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.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.
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 destart 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 e convenções da v2.
Próximos passos
Comece pela v1
Primeira chamada em 5 minutos, listando as unidades da sua rede.
Comece pela v2
Primeira chamada em 5 minutos, listando os produtos do catálogo.