Já possui a Bimer API em funcionamento, mas quer ajuda para colocar a autenticação no Postman para realizar testes de requisição?
Então leia este artigo até o final! (winking face)
Introdução
Para a realização dos testes de requisição no Postman é necessário que a autenticação esteja correta. Assim, siga os passos indicados neste material para prosseguir corretamente com a rotina.
Os passos a seguir são para a Bimer API na versão 11.01.05.00 ou superior.
Autenticação
Para autenticar-se é necessário executar um POST.
Como faço isto?
Ao lado do campo Post deverá ser informada uma URL. A URL a ser utilizada deve ser o endereço no qual a sua API foi instalada seguida do trecho /auth/token. Veja o exemplo:
-
http://<seuservidordaAPI.com.br>/auth/token.
Para essa URL há algumas possibilidades:
-
URL publicada: ficará como o exemplo acima, com o trecho ".com.br" no final;
-
URL não publicada: nesse caso, sua API estará disponível para ser utilizada somente dentro da mesma rede. Assim, ela pode ser informada com IP, nome da máquina ou localhost + : (dois pontos) + número da porta de instalação. Veja abaixo os exemplos nos quais simularemos a instalação na porta 8093:IP: http://172.25.1.1:8093/auth/tokenNome da máquina: http://SERVIDOR:8093/auth/tokenLocalhost: http://locahost:8093/auth/token (A palavra localhost se refere à própria máquina. Assim, só utilize localhost se você estiver realizando o procedimento na mesma máquina em que a API foi instalada.
Além disso, é necessário seguir o padrão de configurações a seguir no campo Body:
-
Conteúdo no corpo do arquivo (campo Key):
-
Username: no campo Value informe o mesmo login do usuário criado no Bimer;
-
Password: no campo Value informe a mesma senha do usuário criado no Bimer.
-
É necessário que o usuário já esteja criado no Bimer e com as devidas permissões.
No campo Header:
-
Verifique no campo Key a chave Content-type;
-
No campo Value informe application/x-www-form-urlencoded
Ao enviar o POST, em caso de sucesso, a aplicação retorna um resultado com a seguinte estrutura:
|
{"accessToken": "eyJ[...]2sxU",
"expiresIn":1736269213,
|
|---|
O token é uma resposta da API, na qual está permitindo comunicação. Esta permissão tem validade padrão de 2 horas.