Copiar página

Não está autenticado. Qualquer mudança que fizer será assinalada como anónimo. You may want to Log In if you already have an account. Também pode Inscrever-se para obter uma nova conta.

<h2>API TI9 - WebService - Manual de utilização</h2> VERSIONAMENTO:<table class="confluenceTable"><tbody><tr><th class="confluenceTh">Versão</th><th class="confluenceTh">Editor</th><th colspan="1" class="confluenceTh">Resumo</th><th class="confluenceTh">Data</th></tr><tr><td class="confluenceTd">1.0</td><td class="confluenceTd">Rogerio Rezende</td><td colspan="1" class="confluenceTd">Versão Java e Tomcat</td><td class="confluenceTd">15/05/2020</td></tr><tr><td colspan="1" class="confluenceTd">1.1</td><td colspan="1" class="confluenceTd">Gabriel Angeli</td><td colspan="1" class="confluenceTd">Senha e Active Directory</td><td colspan="1" class="confluenceTd">11/06/2020</td></tr><tr><td colspan="1" class="confluenceTd"> </td><td colspan="1" class="confluenceTd"> </td><td colspan="1" class="confluenceTd"> </td><td colspan="1" class="confluenceTd"> </td></tr></tbody></table><h2>ESPECIFICAÇÕES</h2>Disponibilizamos abaixo as especificações técnicas para utilização desta API. As chamadas da API (WebService) são síncronas - a cada chamada o serviço irá responder com sucesso ou falha, juntamente com a mensagem de retorno. Pré-requisitos:<ul><li>O serviço deve ser hospedado em um servidor Apache Tomcat 8.5.x, sendo executado na porta 8085 por padrão. Caso a porta já esteja em uso, poderá ser configurada outra porta para esta API;</li><li>O servidor deve ter a instalação do Java 13;</li><li>Uso de um certificado SSL (HTTPS) para garantir a segurança da troca de informação entre os sistemas.</li></ul> Autenticação:A API requer autenticação com um usuário previamente cadastrado no ERP Ti9 e sua respectiva senha criptografada armazenada no banco de dados. A autenticação retorna uma chave codificada (token JWT com expiração em 1 hora, do tipo &quot;Bearer&quot;) que será criada e administrada pela Ti9.A criação do usuário e senha, bem como a atualização da senha periodicamente, devem ser realizadas pela empresa em conjunto com os mantenedores de outras aplicações que utilizem estes dados, visto que os mesmos serão atualizados também na aplicação deles.A criação e a manutenção do usuário devem ser feitas por meio do &quot;Launcher do Ti9 &gt; Central de Segurança &gt; Usuários&quot;, como qualquer outro usuário. Porém, não é necessário configurar nenhuma permissão específica ao usuário, deve-se apenas cadastrá-lo com sua senha.Os softwares devem utilizar o nome informado no campo &quot;Login&quot; e o código MD5 da senha atribuída ao mesmo para a autenticação com a API do Ti9. <img class="emoticon emoticon-warning" data-emoticon-name="warning" border="0" src="/s/pt_PT/3398/84f448c1067609161db7eeaf020f96b084eef29d.1/_/images/icons/emoticons/warning.png" alt="(aviso)" title="(aviso)" /> IMPORTANTE:O padrão adotado pelo TI9 é de armazenar na base de dados a senha de forma maiúscula quando não se utiliza os recursos do Microsoft Active Directory. Portanto, nestes casos, para se gerar o hash md5 da senha, deve-se gerá-lo com os caracteres maiúsculos da senha.Para os casos onde o Active Directory está ativado, deve ser enviado no “request body” o hash md5 gerado considerando os caracteres da senha assim como eles são. Exemplo de Utilização:<a href="https://ipporta">https://ip:porta/erp-api/v4/auth</a><table class="confluenceTable"><tbody><tr><th class="confluenceTh">Request Body:{&quot;login&quot;: &quot;LOGIN&quot;,&quot;senha&quot;: &quot;MD5-DA-SENHA&quot;}</th></tr></tbody></table><table class="confluenceTable"><tbody><tr><th class="confluenceTh">Response:  {&quot;token&quot;: &quot;eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJmcC1hcGkiLCJzdWIiOi...QUxITyJ9.tmI-RuyCvb...&quot;,&quot;type&quot;: &quot;Bearer&quot;}</th></tr></tbody></table>  <hr />