Authorization. O token é criado dentro da plataforma por um usuário administrador, e cada versão da API tem a sua própria gestão.
O token vai puro, sem Bearer
O valor do header é apenas o token, sem prefixo. Não há login, sessão nem refresh: a API é stateless e valida o token a cada chamada.Onde gerar o token da API do SULTS?
O caminho na plataforma é o mesmo para as duas versões:1
Entre como administrador
O token só pode ser criado por um usuário com permissão de administrador.
2
Abra Segurança
No painel inicial, clique no ícone Segurança.
3
Vá em API
No menu lateral esquerdo, clique em API.
4
Escolha a gestão da sua versão
A tela tem duas gestões separadas, Gestão de Tokens v1 e Gestão de Tokens v2. Abra a da versão que você vai usar e crie o token.
Cada versão tem o seu token
Se as suas chamadas passaram a falhar logo depois de você criar um token novo, confira em qual gestão ele nasceu. É o erro mais frequente de quem integra as duas versões ao mesmo tempo.Um token por integração
Crie um token para cada sistema que se conecta ao SULTS e nomeie pelo sistema, por exemploERP Financeiro ou BI Comercial. Assim você revoga um acesso sem derrubar os outros e consegue identificar a origem de cada chamada.
O que nunca fazer com o token
O token dá acesso aos dados da sua rede inteira. Trate como senha de administrador:- Nunca coloque o token no front end. Qualquer visitante consegue ler o código da página.
- Nunca versione o token em repositório, mesmo privado. Use variável de ambiente ou cofre de segredos.
- Nunca compartilhe o mesmo token entre sistemas diferentes.
Por que a API respondeu 401?
A resposta é401, com o corpo {"error": "Acesso não autorizado."} nas duas versões.
Confira nesta ordem: o token foi copiado por inteiro, o header tem o nome exato Authorization, o valor não tem Bearer, e o token é da gestão certa para a versão que você está chamando.
O catálogo completo de erros está na sua versão: erros na v1 ou erros na v2.
Próximos passos
Crie o token da v1
O passo a passo da Gestão de Tokens v1, com prints.
Crie o token da v2
O passo a passo da Gestão de Tokens v2, com prints.