Como adicionar um dispositivo de acesso HTTP Genérico ao Situator?

Integre dispositivos e softwares via HTTP para controle de portas e relés diretamente no Situator.

Objetivo

Este artigo descreve como adicionar e configurar um dispositivo de acesso HTTP Genérico no Situator, permitindo o envio de comandos HTTP para softwares ou hardwares de terceiros por meio de eventos e ações.

Requisitos

Antes de iniciar o procedimento, verifique se todos os requisitos abaixo são atendidos:

• Acesso ao Situator com permissão administrativa;

• Endereço Host/IP do servidor HTTP (software ou hardware);

• Informações de autenticação, caso o sistema utilize Basic Auth;

• Documentação da API HTTP do fabricante (URLs, métodos e parâmetros).

Passo a passo

Adicionar o dispositivo HTTP Genérico

1. Acesse o menu Configurações.

2. Selecione a aba Integrações.

3. Clique na aba Acessos.

4. Clique em Adicionar dispositivo.

5. Preencha os campos conforme abaixo:

   • Fabricante: Seventh;

   • Modelo: Dispositivo HTTP;

   • Nome: informe um nome para o dispositivo;

   • Host: informe o IP ou hostname do servidor HTTP;

   • Quantidade de Relés: informe a quantidade que será integrada;

   • Quantidade de Portas: informe a quantidade que será integrada;

   • Tipo de autenticação:

     • Se não houver autenticação, selecione Nenhum;

     • Se utilizar Basic Auth, preencha Usuário e Senha.

1. Clique em Salvar.

Licenciar portas e relés do dispositivo

1. Após adicionar o dispositivo, clique em Recursos.

2. Selecione as Portas e Relés que serão utilizados.

3. Clique em Adicionar recurso e salve.

Configurar comandos HTTP da porta

1. Clique no ícone de configuração (engrenagem) da porta desejada.

2. Selecione a Ação que será configurada (exemplo: Abrir porta).

3. Defina o Tipo de requisição HTTP (GET, POST, PUT, etc.).

4. No campo URL, informe a URL fornecida pelo fabricante para a ação configurada.

   • Inclua na URL o identificador da porta correspondente (exemplo: porta 1).

5. Caso necessário, configure os Headers HTTP com Keys e Values exigidos pela API.

   

6. Clique em Salvar.

🔁 Para configurar outras ações da mesma porta ou de outras portas, repita o procedimento alterando apenas o Tipo da ação.

Utilização do dispositivo

Após a configuração:

• A porta configurada poderá ser utilizada em ações do Situator;

• Para executar o comando, crie um Evento Manual com a ação Abrir porta;

• Vincule o evento ao dispositivo HTTP e à porta configurada.

Observações importantes

⚠️ As URLs, métodos HTTP e parâmetros utilizados devem seguir exatamente o padrão definido pelo fabricante do software ou hardware integrado.

⚠️ Caso o identificador da porta não seja informado corretamente na URL, a ação não será executada conforme esperado.