Autenticação
Todas as requisições à API são autenticadas por um token do tipo API, enviado no header token. O token identifica a sua Conta: tudo o que for executado com ele acontece nela.
Gerar o token
Abra a tela de tokens
No Sinfonia, acesse Administração → Tokens e clique em + Token.
Preencha os campos
Informe um Label que identifique a integração (por exemplo, erp-faturamento) e escolha o tipo API.
Copie o valor
Clique no ícone ao lado do token para copiá-lo e guarde-o em um local seguro, como um cofre de segredos.
Veja os detalhes da tela em Tokens.
Enviar o token
Inclua o header token em todas as requisições:
curl -X GET "https://sinfonia.live/api/v1/execlog/4512" \
-H "token: SEU_TOKEN"Se o header estiver ausente ou o token for inválido, a API responde 401 Unauthorized.
Boas práticas
- Um token por integração. As execuções disparadas pela API aparecem na plataforma como criadas por
api_<label>, então um label claro mostra qual sistema disparou cada execução. Também permite revogar só uma integração. - Nunca exponha o token no navegador ou em apps. Faça as chamadas a partir do seu servidor.
- Não grave o token no código. Use variáveis de ambiente ou um cofre de segredos. As Variáveis de Ambiente do Sinfonia servem para os seus bots, não para sistemas externos.
- Revogue tokens sem uso. Para remover um token, use o ícone da lixeira na tela de Tokens.
Atenção
O token dá acesso para executar qualquer bot da Conta. Trate-o como uma senha.
Última modificação em