A API do Themis permite integrar o sistema com outras aplicações e automatizar processos por meio do acesso aos dados cadastrados.
Com a autenticação correta, é possível consultar, criar, atualizar e excluir informações utilizando os métodos disponibilizados pela API.
Todas as interações com a API do Themis são realizadas por meio de requisições que enviam e recebem dados no formato JSON.
Criando um usuário de API de integração
Para utilizar a API do Themis, é necessário criar um usuário do tipo API de integração. Esse usuário será responsável por gerar o token utilizado na autenticação das requisições.
Para realizar o cadastro:
Acesse Configurações > Usuário API
Clique em Adicionar
Preencha os dados do usuário:
Nome do usuário: informe um nome que identifique a integração
Login: utilize um e-mail ou outro identificador de acesso
Senha: crie e confirme uma senha
Marque a opção Ativo
Clique em Salvar
💡Dica: Utilize nomes que facilitem a identificação da integração, principalmente quando houver mais de uma aplicação conectada ao Themis.
Utilizando o token de autenticação
Após a criação do usuário, o Themis disponibiliza um token de acesso. Esse token deve ser enviado no cabeçalho (Header) de todas as requisições realizadas para a API.
Exemplo:
X-Aurum-Auth: VEhFTUlTMzpmNjIzZTc1YWYzMGU2MmJiZDczZDZkZjViNTBiYjdiNQ==
Sem o envio do token no cabeçalho da requisição, a API do Themis não permitirá o acesso aos métodos disponíveis.
Regras importantes
Cada usuário de API possui um token exclusivo de autenticação.
Ao inativar ou excluir um usuário de API de integração, todas as requisições realizadas com o token vinculado a esse usuário deixam de funcionar.
Recomenda-se criar usuários de API distintos para cada integração ou aplicação conectada ao Themis.
‼️ Importante: A utilização de usuários separados facilita a gestão de acessos e aumenta a segurança das integrações.
Após criar o usuário e obter o token de autenticação, você já pode utilizar os métodos disponibilizados pela API do Themis para integrar sistemas e automatizar processos.
Ficou com alguma dúvida? Entre em contato com nosso time de suporte pelo e-mail suporte@aurum.com.br ou, se preferir, utilize o ícone de chat disponível diretamente no Themis. Estamos à disposição para ajudar.
Estes artigos podem interessar a você: