Skip to main content
API v2 A v2 é a nova geração da API do SULTS. A migração acontece módulo a módulo, e o primeiro a chegar foi o de Compras.
Você está na documentação da v2. Os módulos que ainda não migraram continuam na v1, que segue em produção e documentada por inteiro. Em dúvida, veja Qual versão eu uso?.

O que já está disponível na API v2?

São 45 endpoints, e a lista completa está na Referência da API.

O que muda da v1 para a v2?

Três diferenças aparecem já na primeira chamada: A base de URL é própria. Os endpoints vivem em https://api.sults.com.br/api/v2/, com uma base por módulo (/compras/, /comunicado/, /chamados/ e /checklist/) e caminhos padronizados por ação, como /list, /add e /edit. O token é outro. A v2 usa a Gestão de Tokens v2, e o token é exibido uma única vez na criação. Tokens das duas versões não são intercambiáveis. A listagem não tem envelope. A v1 devolve data, start, limit e totalPage. A v2 devolve o array direto e pagina por page. Além disso, a v2 expõe o que a v1 nunca teve. Em Compras, preço e estoque em endpoints próprios e o fluxo de etapas de pedido. Em Chamados, interações, apoios, etiquetas e prazo, cada um com a sua chamada. Em Checklist, os modelos com seções e questões e a listagem de planos de ação com filtros.

Sua jornada até a produção

1

Faça a primeira chamada

Gere o token da v2 e liste os produtos do catálogo em 5 minutos no quickstart.
2

Aprenda as convenções

Paginação por page, datas e formatos estão em Convenções.
3

Prepare a integração para falhas

Trate os erros desde o início, com o catálogo em Erros.
4

Monte o seu fluxo

Para manter o seu sistema atualizado, siga o padrão de varredura descrito em Como manter os dados atualizados.

Próximos passos

Comece em 5 minutos

Do token à primeira resposta, com exemplos em cinco linguagens.

Referência da API

Os 45 endpoints da v2, com playground para testar do navegador.