# Endpoints de Integração

Utilize essa funcionalidade para configurar diferentes endpoints de integração.

# Configurando múltiplos endpoints

A funcionalidade de configuração de múltiplos IPs permite a atonomia do usuário para alterar seu Endpoint de integração com liberdado quando for necessário.

<p class="callout info">**MÓDULO**</p>

Gestão de Manutenção

<p class="callout info">**CAMINHO PADRÃO**</p>

Menu Configurações - Endpoints de Integração

<p class="callout info">**O ENDPOINT** </p>

O endpoint é composto pelo protocolo usado, endereço e porta (caso necessário).

Para melhor entender vamos a um exemplo: vamos considerar que o endpoint que necessitamos cadastrar é para o IP **11.140.97.107**, onde utiliza o protocolo **HTTP** na porta **8080**.

Para isso então cadastraremos o endpoint como: **http://11.140.97.107:8080**

Todos os endpoints devem seguir o mesmo conceito para o correto funcionamento. Para funcionamento da troca automática, ao acessar este endereço através de uma requisição http, deve-se retornar um código HTTP **200 OK**, caso contrário, **não haverá como garantir o funcionamento correto**.

<p class="callout info">**CONFIGURANDO**</p>

Com um perfil **Administrador**, siga o caminho padrão:

1. Clique em "Adicionar" no canto direito superior;
2. No campo "Descrição" forneça um nome para o grupo, por exemplo: endereço interno;
3. Clique em "Salvar" e "Voltar";
4. No campo "Ação" clique no ícone de documento;
5. Clique em "Adicionar" no canto direito superior;
6. Forneça uma descrição e um IP Endpoint;
7. Clique em "Salvar".

<p class="callout warning">**DÚVIDAS**</p>

<table border="1" id="bkmrk-d%C3%BAvida-resolu%C3%A7%C3%A3o-dir" style="border-collapse: collapse; width: 100%; height: 59.5938px;"><tbody><tr style="height: 29.7969px;"><td style="width: 40.6626%; height: 29.7969px;">**Dúvida**</td><td style="width: 51.55%; height: 29.7969px;">**Resolução**</td><td style="width: 7.78739%; height: 29.7969px;">**Direito**</td></tr><tr style="height: 29.7969px;"><td style="width: 40.6626%; height: 29.7969px;">Não visualizo a opção de Endpoints de integração.</td><td style="width: 51.55%; height: 29.7969px;">Verifique se seu perfil de usuário é Administrador. </td><td class="align-center" style="width: 7.78739%; height: 29.7969px;">-</td></tr></tbody></table>

# Alterando o Endpoint

A funcionalidade de configuração de múltiplos IPs permite a atonomia do usuário para alterar seu Endpoint de integração manualmente com liberdade quando for necessário.

Lembrando de que, este processo não é obrigatório, visto que há o processo de troca automática já citado nas outras páginas desta documentação.

<p class="callout info">**MÓDULO**</p>

Gestão de Manutenção.

<p class="callout info">**CAMINHO PADRÃO**</p>

Menu Configuração -&gt; Endpoints de Integração

<p class="callout info">**ALTERANDO ENPOINT**</p>

Com um perfil **Administrador**, siga o caminho padrão:

1. Após seguir o caminho padrão, clique na opção no campo "Ação" do lado direito da tela;
2. Localize o endereço IP que deseja ativar e clique no botão "Ativar", no campo "Ação";
3. Clique em "Sim, quero alterar" no alerta "Tem certeza que deseja ALTERAR o Endpoint?".
4. Endpoint alterado.

<p class="callout warning">**DÚVIDAS**</p>

<div class="pointer-container" id="bkmrk-%C2%A0"><div class="pointer anim is-page-editable"><svg class="svg-icon" data-icon="link" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg><div class="input-group inline block"> <button class="button outline icon" data-clipboard-target="#pointer-url" title="Copiar Link" type="button"><svg class="svg-icon" data-icon="copy" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg></button></div><svg class="svg-icon" data-icon="edit" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg></div></div><table border="1" id="bkmrk-d%C3%BAvida-resolu%C3%A7%C3%A3o-dir" style="width: 99.8765%; height: 59.5938px;"><tbody><tr style="height: 29.7969px;"><td style="width: 45.758%; height: 29.7969px;">**Dúvida**</td><td style="width: 45.6189%; height: 29.7969px;">**Resolução**</td><td style="width: 8.62309%; height: 29.7969px;">**Direito**</td></tr><tr style="height: 29.7969px;"><td style="width: 45.758%; height: 29.7969px;">Não visualizo a opção de Endpoints de integração.</td><td style="width: 45.6189%; height: 29.7969px;">Verifique se seu perfil de usuário é Administrador. </td><td class="align-center" style="width: 8.62309%; height: 29.7969px;">-</td></tr></tbody></table>

# Entendendo o Conceito

Os Endpoints de Integração é como chamamos a nossa ferramenta de "*failover*".

Em resumo, "*failover*" se baseia em haver mais de uma forma de acesso a um determinado recurso, sendo efetuadas tentativas em uma determinada sequência, onde apenas a primeira que estiver disponível será utilizada para o acesso.

No SISMETRO, a ferramenta de "Endpoints de Integração" permite o cadastro de diversos endereços, onde através da sequência desejada, é possível definir quais devem ser utilizados para a conexão em uma integração.

O processo de troca de endpoint ocorre de forma automática e manual. Na forma automática, um processo é executado a cada hora, onde se testam os endpoints e o primeiro que responder entra em vigor até a próxima validação ou a ativação manual. Na forma manual, é possível através de um clique efetuar a troca na hora do endpoint, porém, ficará válido até a próxima validação automática ou troca manual, o que ocorrer primeiro.

No cadastro de endpoints, você possuirá um grupo de endpoints, onde indicará todos os endereços relacionados. Este grupo de endpoints estará ativo nas integrações que ele estiver vinculado. Para efetuar o vínculo deve-se solicitar ao Suporte SISMETRO para o fazer.

Nas próximas páginas desta documentação possui como é possível cadastrar os endpoints e como gerenciá-los.