Skip to main content
API v2 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.
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.

​
Faça uma chamada autenticada

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

Referência da API v2

Os 45 endpoints da v2, em Compras, Comunicados, Chamados e Checklist, com métodos e URLs.

Qual versão eu uso?

Confira em segundos se a sua integração é v1 ou v2.