Escopo
O objetivo desta documentação é explicar os passos fundamentais para que seja possível consumir a API, e acessar a documentação no Swagger.
Para acesso as APIs, você deverá também liberar acesso no MOVERE para realizar as consultas.
Para isso siga as instruções na base de conhecimento https://meajuda.moveresoftware.com/a/solutions/articles/27000068992
Acesso ao Swagger
Para acessar o Swagger do MOVERE API, basta apenas digitar na URL do navegador o endereço parecido com este: "https://api.moveresoftware.com/swagger", e você será redirecionado para a nossa documentação. E será exibido algo parecido como no exemplo abaixo:
Ao clicar em um grupo, por exemplo Aplicativo Vendedor, as API's serão exibidas:
Obs: as API's de anexo de nota de entrada e de título a pagar estão obsoletas, não estando disponível na nova versão (informando o ambiente).
Obtenção do Token
Toda e qualquer requisição que for realizada no MOVERE API deverá conter o token no header da requisição, sendo assim, para se obter este token será necessário realizar o login através da API. Veja o exemplo abaixo, onde está sendo realizado o login pelo próprio swagger.
Basta informar as credenciais: usuário, senha, e o ambiente. O usuário e senha informado deve ser os dados de acesso de um usuário do MOVERE, que possua acesso a rotina [R1000 - Central de Integração], já o ambiente será informado pelo suporte.
Após informar as credenciais, clique no botão Try it out!, que a resposta da requisição conterá o token desejado:
Realizando requisições na API via Swagger
Uma vez obtido o token, você deverá coloca no cabeçalho da página no campo Token (ao lado da URL) o texto Bearer + um espaço + o token sem as aspas. Somente o conteúdo:
Basta clicar em Explore e aguardar. Ele poderá apresentar a mensagem abaixo indicando que está se conectando:
Depois de conectado, pronto, a tela com as APIs estarão disponíveis para uso:
Realizando requisições na API via Postman
Para se realizar requisições de testes na API poderá ser utilizado o Postman, por exemplo, onde poderá ser adicionado o token no header da requisição, ou pela aba Authorization:
Após isso, será necessário montar o corpo da requisição, onde conterá o JSON que no Swagger é especificado como é o exemplo de parâmetro.
Para realizar a requisição preste atenção qual o verbo HTTP (GET, POST, PUT, DELETE) é necessário utilizar, esta informação também é fornecida no Swagger.
Obs: O Postman foi utilizado somente para realizar testes, sendo assim, o client utilizado sempre fica a escolha do desenvolvedor.