MPI/API/KeepAlive
De uTech Tecnologia
(Diferença entre revisões)
(→Evento) |
|||
Linha 22: | Linha 22: | ||
| align="left"| '''port''' || Porta local da API do porteiro, utilizada para receber comandos vindo da aplicação (Configurado menu '''Geral''', aba '''Integração''' - '''Configuração do Servidor'''. Campo '''Porta'''). Dados passados via JSON. | | align="left"| '''port''' || Porta local da API do porteiro, utilizada para receber comandos vindo da aplicação (Configurado menu '''Geral''', aba '''Integração''' - '''Configuração do Servidor'''. Campo '''Porta'''). Dados passados via JSON. | ||
|- | |- | ||
− | | align="left"| '''rport''' || Porta externa da API do porteiro para receber comandos oriundos da aplicação. Porta mapeada no '''NAT''' via '''UPnP'''.(Configurado no menu '''Rede''', aba '''UPnP''' - '''Porta Externa de Integração'''. Campo '''Porta'''). Dados passados via JSON. | + | | align="left"| '''rport''' || Porta externa da API do porteiro para receber comandos oriundos da aplicação. Porta mapeada no '''NAT''' via '''UPnP'''. (Configurado no menu '''Rede''', aba '''UPnP''' - '''Porta Externa de Integração'''. Campo '''Porta'''). Dados passados via JSON. |
|} | |} | ||
Edição de 13h25min de 19 de novembro de 2021
Tabela de conteúdo |
O Evento Keepalive é enviado do porteiro para a aplicação para supervisão da conexão.
Este evento é enviado a cada N segundos.
O tempo entre envios do evento é configurado no menu Geral, aba Integração - Configuração do Cliente. Campo Keepalive.
NOTA: Por padrão, o valor desta configuração é 0 (zero). o valor zero DESABILITA o envio do evento keepalive. |
Evento
Parâmetros enviados pelo Porteiro | |
---|---|
request | keepalive |
ip | Endereço IP do porteiro. Dados passados via JSON. |
port | Porta local da API do porteiro, utilizada para receber comandos vindo da aplicação (Configurado menu Geral, aba Integração - Configuração do Servidor. Campo Porta). Dados passados via JSON. |
rport | Porta externa da API do porteiro para receber comandos oriundos da aplicação. Porta mapeada no NAT via UPnP. (Configurado no menu Rede, aba UPnP - Porta Externa de Integração. Campo Porta). Dados passados via JSON. |
Exemplo
POST /?request=keepalive HTTP/1.1 Content-Type: application/json Content-Length: { "ip":"10.0.0.1", "port":"8080", "rport":"38080" } |
---|
Resposta: A aplicação deve responder:
- 401 => Erro de Autenticação.
- 200 => OK.
PHP
<?php $vars = $_REQUEST; if(!isset($vars)) exit(0); if(isset($vars['request']) && strcmp($vars['request'],"keepalive") == 0) $event = $vars['request']; else { echo "Evento invalido!\n"; exit(1); } print_r(json_decode($result, true)); ?> |