Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


CONTEÚDO

  1. Visão Geral
  2. Requisitos
  3. Exemplo de utilização
  4. Tela Novo Cliente
    1. Outras Ações / Ações relacionadas
  5. Demonstração


*ATENÇÃO*: As APIs V2 não devem substituir as antigas APIs, uma estrutura deve ser criada a parte para elas.

01. VISÃO GERAL

Passo-a-passo para cadastro de clientes para ter acesso a Apiàs APIs de integração do RMS.

...

02.  REQUISITOS

       Instalar o API Manager utilizando este link.

       Baixar o pacote da aplicação API-Manager e das APIs Auth7 e APIZeus.

       Os mesmo do projeto RMSMenu projeto RMSMenu Web, contudo requer a versão do .NET Core precisa ser igual ou superior a 3.1.

...

3.1 ou superior. 

       Observação: no caso de ambiente 64bits, devem ser instaladas as versões x64, x86.

       Observação: O hosting bundle também dever ser instalado independente da versão do Windows.

       Observação: O item WebDavModule deve ser removido do item abaixo

Image Added


...

03. INSTALAÇÃO DA SOLUÇÃO

       Devem ser instalados os pré-requisitos listados acima e seguir com os passos abaixo. Alguns dos passos abaixo já podem ter sido executados com a instalação do API-Manager.

  1. Criar os pools de aplicação no IIS conforme abaixo.
    1. Image Added
  2. Entrar nas configurações avançadas de cada um dos três pools listados acima.
    1. Image Added
  3. Alterar os campos de compatibilidade para 32bits para "True" e a identidade para "LocalSystem".
    1. Image Added
  4. Copiar o conteúdo das APIs Auth7 e APIZeus para a pasta C:\inetpub\wwwroot\RMS\RMSServices
    1. Image Added
    2. Image Added
  5. Copiar o conteúdo do API-Manager para a pasta C:\inetpub\wwwroot\RMS\Aplicacoes
    1. Image Added
    2. Image Added
  6. Converter a aplicação API-Manager para aplicação e selecionar o pool criado para a API-Manager.
    1. Image Added
    2. Image Added
    3. Image Added
  7. Converter as APIs APIZeus e Auth7 para aplicação e selecionar o pool criado para as APIs.
    1. Image Added
    2. Image Added
    3. Image Added

04EXEMPLO DE UTILIZAÇÃO

         11. Na tela de listagem de clientes cadastrados, clicar no botão "Novo Cliente":

Image RemovedImage Added


2. Preencher com a Razão Social e CNPJ do cliente, em seguida clicar em "Salvar":

Image RemovedImage Added


3. A senha gerada nesta etapa é utilizada para recuperar um token durante as requisições. A senha será exibida apenas neste momento não podendo ser recuperada. Em caso de perda será necessário criar um novo cadastro:

Image RemovedImage Added

4. Realizar requisição em "dominio/rms/rmsservices/auth7/api/v1/Credentials/company/Signin" para retornar um token:

Image Added

5. Exemplo de requisição com token :válido:

Image Added

6. Exemplo de requisição com token inválido, nesse a expressão "invalid token" é exibida no response:

Image Added

7. Exemplo de requisição sem token, neste caso é recepcionado o erro 401:

Image AddedImage Removed


Obs.: O token por padrão possui validade de 8 horas. Para ajustar é necessário altera o seguinte arquivo appsettings.json no parâmetro TokenExpireTimeInHours e reiniciar o pool da aplicação

...



...

05TELA NOVO CLIENTE

Outras Ações / Ações relacionadas

AçãoDescrição
Razão SocialRazão Social do cliente irá acessar API
CNPJCNPJ do cliente irá acessar API

...

06DEMONSTRAÇÃO




HTML
<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>