MPI/API/KeepAlive
De uTech Tecnologia
(Diferença entre revisões)
(Criou página com ' __TOC__ 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...') |
(→Exemplo) |
||
| (3 edições intermediárias de um usuário não apresentadas) | |||
| Linha 2: | Linha 2: | ||
__TOC__ | __TOC__ | ||
| − | O Evento '''Keepalive''' é enviado do porteiro para a aplicação para supervisão da conexão. Este evento é enviado a cada '''N''' segundos. | + | O Evento '''Keepalive''' é enviado do porteiro para a aplicação para supervisão da conexão.<BR> |
| − | O tempo entre envios do evento é configurado no menu '''Geral''', aba '''Integração''' - '''Configuração do Cliente'''. Campo '''Keepalive'''. | + | 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'''.<BR> | ||
{| style="width: 65%; background-color: orange;" | {| style="width: 65%; background-color: orange;" | ||
| − | |'''NOTA''': Por padrão, o valor desta configuração é 0 (zero) | + | |'''NOTA''': Por padrão, o valor desta configuração é 0 (zero). o valor zero '''DESABILITA''' o envio do evento keepalive. |
|} | |} | ||
| − | |||
| − | |||
== Evento == | == Evento == | ||
| Linha 23: | 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. |
|} | |} | ||
| + | <BR><BR> | ||
== Exemplo == | == Exemplo == | ||
Edição atual tal como 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. |
[editar] 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. |
[editar] 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.
[editar] 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)); ?> |
