MPI/API/EvtMifireNFC
De uTech Tecnologia
(Diferença entre revisões)
(→Buitl-in Respose) |
|||
(17 edições intermediárias de um usuário não apresentadas) | |||
Linha 6: | Linha 6: | ||
== Evento == | == Evento == | ||
− | {| class="wikitable" width=" | + | {| class="wikitable" width="75%" |
! align="center" colspan="2" | Parâmetros enviados pelo Porteiro | ! align="center" colspan="2" | Parâmetros enviados pelo Porteiro | ||
|- | |- | ||
Linha 18: | Linha 18: | ||
* '''detected''': Cartão/NFX detectado. Enviado quando o equipamento não está configurado no modo ''stadalone''. Evento é repassado para a aplicação de terceiros. | * '''detected''': Cartão/NFX detectado. Enviado quando o equipamento não está configurado no modo ''stadalone''. Evento é repassado para a aplicação de terceiros. | ||
* '''doublepass''': Passagem dupla detectada (Utilizado para controle de dupla passagem). | * '''doublepass''': Passagem dupla detectada (Utilizado para controle de dupla passagem). | ||
+ | * '''panic''': Estado enviado quando o usuário estiver configurado como '''Pânico''' (Campo '''Habilitar Pânico''' de cada usuário do porteiro). | ||
|- | |- | ||
| align="left"| '''key''' || Chave primária do usuário. | | align="left"| '''key''' || Chave primária do usuário. | ||
|- | |- | ||
| align="left"| '''interface''' || Identificação da interface acessada/acionada. | | align="left"| '''interface''' || Identificação da interface acessada/acionada. | ||
+ | * '''0''': Interface de acionamento 1 e 2 do porteiro (Quando selecionado para acionamento simultâneo das interfaces 1 e 2). | ||
* '''1''': Interface de acionamento 1 do porteiro. | * '''1''': Interface de acionamento 1 do porteiro. | ||
* '''2''': Interface de acionamento 2 do porteiro. | * '''2''': Interface de acionamento 2 do porteiro. | ||
− | * '''3 a 32''': Interface de acionamento externo. | + | * '''3 a 32''': Interface de acionamento externo. Leitor ou Porteiro ''slave''. Ver [[MPI/ConfiguracaoWEB#Leitores|Leitores Externos]] |
|- | |- | ||
| align="left"| '''time''' || Data/Hora do evento no formato '''ddmmYYYYHHMMSS''' onde: | | align="left"| '''time''' || Data/Hora do evento no formato '''ddmmYYYYHHMMSS''' onde: | ||
Linha 39: | Linha 41: | ||
{| class="wikitable" | {| class="wikitable" | ||
− | ! style="text-align: left; font-weight: bold;" | <pre>http://ip:porta/url/?request=card&card=EAD2353236FAC&state=blocked&key=2ed1698bcf | + | ! style="text-align: left; font-weight: bold;" | <pre>http://ip:porta/url/?request=card&card=EAD2353236FAC&interface=1&state=blocked&key=2ed1698bcf&time=10122018183000 |
</pre> | </pre> | ||
|} | |} | ||
Linha 47: | Linha 49: | ||
* '''401''' => Erro de Autenticação. | * '''401''' => Erro de Autenticação. | ||
* '''200''' => OK. | * '''200''' => OK. | ||
+ | |||
+ | <BR><BR> | ||
+ | === Buitl-in Respose === | ||
+ | |||
+ | No próprio evento, é possível executar outros comandos, inserindo no corpo da resposta (no caso '''200 OK''') enviado pela aplicação, um ''array'' com os dados do comando a ser executado. Os parâmetros aceiros são descritos abaixo: | ||
+ | |||
+ | {| class="wikitable" width="65%" | ||
+ | ! align="center" colspan="2" | Parâmetros enviados para o Porteiro | ||
+ | |- | ||
+ | | align="left"| request || Comando a ser enviado. Comandos aceitos: '''relay''' ou '''play'''. | ||
+ | |- | ||
+ | | align="left"| interface || '''Para relay''': Define qual relê será habilitado ou desligado | ||
+ | * '''0''': Ambas interfaces (1 e 2). | ||
+ | * '''1''': Interface 1. | ||
+ | * '''2''': Interface 2. | ||
+ | |- | ||
+ | | align="left"| state || '''Para relay''': Define o estado do relê: | ||
+ | * '''on:''' => Ligado | ||
+ | * '''off:''' => Desligado | ||
+ | * '''hold:''' => Mantem aberta porta/relê até receber um evento '''off''' da API ou um comando externo (ex. interface WEB, DTMF). | ||
+ | |- | ||
+ | | align="left"| message || '''Para play''': Define a mensagem a reproduzir. Ver mensagens na documentação do comando [[MPI/API/PlayMessage|'''PlayMessage''']] | ||
+ | |} | ||
+ | |||
+ | '''Exemplo - acionando o relê para abertura da interface 1''': | ||
+ | {| class="wikitable" | ||
+ | ! style="text-align: left; font-weight: bold;" | <pre>HTTP/1.1 200 OK | ||
+ | Content-Type: application/json | ||
+ | Content-Length: 167 | ||
+ | { | ||
+ | "request" :"relay", | ||
+ | "interface": "1", | ||
+ | "state" :"on" | ||
+ | } | ||
+ | </pre> | ||
+ | |} | ||
+ | |||
+ | |||
+ | |||
+ | '''Exemplo - acionando o relê para abertura da interface 1 e reproduzindo a mensagem de ''acesso liberado''''': | ||
+ | {| class="wikitable" | ||
+ | ! style="text-align: left; font-weight: bold;" | <pre>HTTP/1.1 200 OK | ||
+ | Content-Type: application/json | ||
+ | Content-Length: 167 | ||
+ | |||
+ | [ | ||
+ | { | ||
+ | "request" :"relay", | ||
+ | "interface": "1", | ||
+ | "state" :"on" | ||
+ | }, | ||
+ | { | ||
+ | "request" :"play", | ||
+ | "message" :"access_allowed" | ||
+ | } | ||
+ | ] | ||
+ | |||
+ | </pre> | ||
+ | |} | ||
+ | |||
<br/><br/> | <br/><br/> | ||
== PHP == | == PHP == | ||
+ | |||
+ | == Evento Simples == | ||
+ | |||
{| class="wikitable" width="65%" | {| class="wikitable" width="65%" | ||
| | | | ||
Linha 71: | Linha 136: | ||
printf("=> Card: %s<BR>\n", $vars['card']); | printf("=> Card: %s<BR>\n", $vars['card']); | ||
printf("=> State: %s<BR>\n", $vars['state']); | printf("=> State: %s<BR>\n", $vars['state']); | ||
+ | printf("=> Time: %s<BR>\n", $vars['time']); | ||
printf("=> Key: %s<BR>\n", $vars['key']); | printf("=> Key: %s<BR>\n", $vars['key']); | ||
?> | ?> | ||
Linha 76: | Linha 142: | ||
|} | |} | ||
− | < | + | |
− | < | + | |
+ | == Evento com Resposta Built-in == | ||
+ | |||
+ | {| class="wikitable" width="65%" | ||
+ | | | ||
+ | <source lang="php"> | ||
+ | <?php | ||
+ | |||
+ | $vars = $_REQUEST; | ||
+ | |||
+ | if(!isset($vars)) | ||
+ | exit(0); | ||
+ | |||
+ | if(isset($vars['request']) && strcmp($vars['request'],"card") == 0) | ||
+ | $event = $vars['request']; | ||
+ | else { | ||
+ | exit(1); | ||
+ | } | ||
+ | |||
+ | # Dados recebido no evevento do porteiro | ||
+ | #printf("Evento: %s<BR>\n", $vars['request']); | ||
+ | #printf("=> Card: %s<BR>\n", $vars['card']); | ||
+ | #printf("=> State: %s<BR>\n", $vars['state']); | ||
+ | #printf("=> Time: %s<BR>\n", $vars['time']); | ||
+ | #printf("=> Key: %s<BR>\n", $vars['key']); | ||
+ | |||
+ | |||
+ | ## Verifricvar se o cartão tem acesso e responder com o comando de liberacao. | ||
+ | ## | ||
+ | |||
+ | $data = array ( | ||
+ | 0 => array ('request' => 'relay', | ||
+ | 'interface' => '1', | ||
+ | 'state' => 'on'), | ||
+ | |||
+ | 1 => array ('request' => 'play', | ||
+ | 'message' => 'access_allowed'), | ||
+ | ); | ||
+ | |||
+ | header('Content-type: application/json'); | ||
+ | echo json_encode( $data ); | ||
+ | |||
+ | ?> | ||
+ | |||
+ | </source> | ||
+ | |} | ||
+ | |||
<br/> | <br/> | ||
[[MPI/API#Eventos|'''Voltar''']] | [[MPI/API#Eventos|'''Voltar''']] | ||
----- | ----- |
Edição atual tal como 22h08min de 29 de julho de 2019
Tabela de conteúdo |
O Evento Mifire/NFC é enviado do porteiro para a aplicação, informando evento de cartão mifire / NFC.
[editar] Evento
Parâmetros enviados pelo Porteiro | |
---|---|
request | card |
card | Identificação do cartão Mifire/NFC |
state | Status do cartão/Evento
|
key | Chave primária do usuário. |
interface | Identificação da interface acessada/acionada.
|
time | Data/Hora do evento no formato ddmmYYYYHHMMSS onde:
|
[editar] Exemplo
http://ip:porta/url/?request=card&card=EAD2353236FAC&interface=1&state=blocked&key=2ed1698bcf&time=10122018183000 |
---|
Resposta: A aplicação deve responder:
- 401 => Erro de Autenticação.
- 200 => OK.
[editar] Buitl-in Respose
No próprio evento, é possível executar outros comandos, inserindo no corpo da resposta (no caso 200 OK) enviado pela aplicação, um array com os dados do comando a ser executado. Os parâmetros aceiros são descritos abaixo:
Parâmetros enviados para o Porteiro | |
---|---|
request | Comando a ser enviado. Comandos aceitos: relay ou play. |
interface | Para relay: Define qual relê será habilitado ou desligado
|
state | Para relay: Define o estado do relê:
|
message | Para play: Define a mensagem a reproduzir. Ver mensagens na documentação do comando PlayMessage |
Exemplo - acionando o relê para abertura da interface 1:
HTTP/1.1 200 OK Content-Type: application/json Content-Length: 167 { "request" :"relay", "interface": "1", "state" :"on" } |
---|
Exemplo - acionando o relê para abertura da interface 1 e reproduzindo a mensagem de acesso liberado:
HTTP/1.1 200 OK Content-Type: application/json Content-Length: 167 [ { "request" :"relay", "interface": "1", "state" :"on" }, { "request" :"play", "message" :"access_allowed" } ] |
---|
[editar] PHP
[editar] Evento Simples
<?php $vars = $_REQUEST; if(!isset($vars)) exit(0); if(isset($vars['request']) && strcmp($vars['request'],"card") == 0) $event = $vars['request']; else { echo "Evento invalido!\n"; exit(1); } printf("Evento: %s<BR>\n", $vars['request']); printf("=> Card: %s<BR>\n", $vars['card']); printf("=> State: %s<BR>\n", $vars['state']); printf("=> Time: %s<BR>\n", $vars['time']); printf("=> Key: %s<BR>\n", $vars['key']); ?> |
[editar] Evento com Resposta Built-in
<?php $vars = $_REQUEST; if(!isset($vars)) exit(0); if(isset($vars['request']) && strcmp($vars['request'],"card") == 0) $event = $vars['request']; else { exit(1); } # Dados recebido no evevento do porteiro #printf("Evento: %s<BR>\n", $vars['request']); #printf("=> Card: %s<BR>\n", $vars['card']); #printf("=> State: %s<BR>\n", $vars['state']); #printf("=> Time: %s<BR>\n", $vars['time']); #printf("=> Key: %s<BR>\n", $vars['key']); ## Verifricvar se o cartão tem acesso e responder com o comando de liberacao. ## $data = array ( 0 => array ('request' => 'relay', 'interface' => '1', 'state' => 'on'), 1 => array ('request' => 'play', 'message' => 'access_allowed'), ); header('Content-type: application/json'); echo json_encode( $data ); ?> |