MCI/API/CmdSetConfig
De uTech Tecnologia
(Diferença entre revisões)
(→Comando) |
|||
Linha 2: | Linha 2: | ||
__TOC__ | __TOC__ | ||
− | O comando '''Configurar | + | O comando '''Configurar Catraca''' é utilizado alterar as configurações básicas da catraca. |
== Comando == | == Comando == |
Edição de 16h13min de 29 de julho de 2019
Tabela de conteúdo |
O comando Configurar Catraca é utilizado alterar as configurações básicas da catraca.
Comando
MÉTODO: POST
Parâmetros enviados para a Catraca | |
---|---|
request | setconfig |
POST-DATA:
Parâmetros enviados para a Catraca via JSON | |
---|---|
dhcp | Identifica se o cliente dhcp está habilitado.
|
ip | Endereço IP da catraca. |
netmask | Endereço da mascara de rede da catraca. |
gateway | Endereço da rota padrão da catraca. |
dns | Endereço do servidor DNS primário da catraca. |
ntp | Endereço do servidor NTP da catraca. |
keyboard | Define se está habilitado ou não o teclado da catraca.
|
keyboard_sound | Habilita ou desabilita beep ao pressionar as teclas do teclado. |
sharp_cancel | Utilizar a tecla Sharp (#) como tecla para cancelar operação.
|
asterisk_password | Utilizar a tecla asterisco (*) como tecla para operação de login.
|
password_timeout | Tempo, em segundos, de timeout que a catraca irá esperar os dígitos de login e senha.
|
display | Define se o display da catraca ficará ligado ou desligado.
|
display_text | Texto/Informação que será mostrado durante o estado de stand by da catraca. Texto será truncado caso ultrapasse 20 caracteres. |
backlight | Define se a iluminação do display permanecerá ligada ou desligada durante operação (no cado de display=true).
|
volspeaker | Volume do alto falante (min:0 - max:20) |
http_server | Cliente - Endereço do Servidor de Integração. |
http_port | Cliente - Porta do Servidor de Integração. |
http_username | Cliente - Usuário do Servidor de Integração. |
http_password | Cliente - Senha do Servidor de Integração. |
http_url | Cliente - URL do Servidor de Integração. |
http_timeout | Cliente - Timeout da Requisição em segundos. |
http_retries | Cliente - Número de Tentativas da Requisição. |
httpd_username | Servidor - Usuário de acesso das aplicações a API da Catraca IP MCI. |
httpd_password | Servidor - Senha de acesso das aplicações a API da Catraca IP MCI. |
httpd_port | Servidor - Porta que a Catraca IP receberá conexões das aplicações. |
httpd_timeout | Servidor - Timeout para conexão TCP. |
httpd_auth | Servidor - Se habilitado, a Catraca IP MCI aceitará conexões de todos os usuários configurados (com conta e senha). |
standalone | define se a catraca irá operar no modo standalone ou não.
|
unlock | Define se o controle de acesso da catraca está habilita ou não. Se desabilitado, libera a passagem de entrada e saída sem controle.
|
announce | Se habilitado, reproduz mensagem para os usuários, como por exemplo: "Acesso liberado" ou "Dupla passagem não permitida". Se desabilitado, emitirá apenas bipes.
|
alarm_type | Define tipo do alarme que será reproduzido quando o alarme da catraca for acionado. Valores de 0 a 4. |
lock_direction | Define qual o método de bloqueio e controle utilizado na catraca. Como a catraca será utilizada. Para entrada e saída, somente entrada ou somente saída.
|
unlock_direction | Define se catraca terá algum sentido liberado.
|
rotation | Define o sentido / referência de rotação da catraca.
|
control_time | Tempo de Acionamento - Tempo, em segundos, que a catraca manterá o acesso liberado para entrada e saída quando detectado usuário válido (Cartão, biometria, etc...) |
control_acc_time | Tempo de Acionamento para Acessibilidade - Tempo, em segundos, que a catraca manterá o acesso liberado para entrada e saída quando detectado usuário válido (Cartão, biometria, etc...) e o mesmo estiver cadastrado como Acessibilidade (Ver Usuários) |
collector_time | Tempo de Acionamento do Coletor- Tempo, em segundos, que a catraca manterá o coletor de cartões aberto ao detectar um cartão válido. |
doublepass_timeout | Tempo, em segundos, que a catraca manterá o acesso bloqueado ao detectar uma dupla passagem (Anti-Passback). |
Exemplo
POST /?request=setconfig HTTP/1.1 Content-Type: application/json Content-Length: 167 { "model":"MCI-41E", "serial":"0000004354", "mac":"F8:E7:B5:00:00:01", "release":"1.1.1", "dhcp":"off", "ip":"10.0.0.2", "netmask":"255.255.255.0", "gateway":"10.0.0.1", "dns":"1.1.1.1", "ntp":"pool.ntp.br", "keyboard":"true", "keyboard_sound":"1", "sharp_cancel":"false", "asterisk_password":"false", "password_timeout":"3", "display":"true", "display_text":"", "backlight":"true", "volspeaker":"20", "http_server":"10.0.0.200", "http_port":"8090", "http_username":"admin", "http_password":"1234", "http_url":"", "http_timeout":"30", "http_retries":"1", "httpd_username":"admin", "httpd_password":"1234", "httpd_port":"8080", "httpd_timeout":"60", "httpd_auth":"true", "standalone":"true", "unlock":"false" "announce":"true", "alarm_type":"0", "lock_direction":"both", "unlock_direction":"none", "rotation":"clockwise", "control_time":"3000", "control_acc_time":"30000", "collector_time":"1000", "doublepass_timeout":"30" } |
---|
Resposta:
- 400 => Parâmetros incorretos
- 401 => Erro de autenticação da API
- 200 => OK
PHP
<?php $user = "utech"; $pass = "1234"; $port = "8080"; $ipaddr = "10.0.0.1"; $data = array( "dhcp" =>"off", "ip" =>"10.0.0.2", "netmask" =>"255.255.255.0", "gateway" =>"10.0.0.1", "dns" =>"1.1.1.1", "ntp" =>"pool.ntp.br", "keyboard" =>"true", "keyboard_sound" =>"1", "sharp_cancel" =>"false", "asterisk_password" =>"false", "password_timeout" =>"3", "display" =>"true", "display_text" =>"", "backlight" =>"true", "volspeaker" =>"20", "http_server" =>"10.0.0.20", "http_port" =>"8090", "http_username" =>"admin", "http_password" =>"1234", "http_url" =>"", "http_timeout" =>"30", "http_retries" =>"1", "httpd_username" =>"admin", "httpd_password" =>"1234", "httpd_port" =>"8080", "httpd_timeout" =>"60", "httpd_auth" =>"true", "standalone" =>"true", "unlock" =>"false" "announce" =>"true", "alarm_type" =>"0", "lock_direction" =>"both", "unlock_direction" =>"none", "rotation" =>"clockwise", "control_time" =>"3000", "control_acc_time" =>"30000", "collector_time" =>"1000", "doublepass_timeout" =>"30" ); $data_string = json_encode($data); $url = "$ipaddr:$port?request=setconfig"; $ch = curl_init($url); curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC); curl_setopt($ch, CURLOPT_USERPWD, "$user:$pass"); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST"); curl_setopt($ch, CURLOPT_POSTFIELDS, $data_string); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, array( 'Content-Type: application/json', 'Content-Length: ' . strlen($data_string)) ); $result = curl_exec($ch); if(!$result) { echo "error!\n"; return 2; } $fs = preg_replace("/<html><body>/", "", "$result"); $rc = preg_replace("/<\/body><\/html>/", "", "$fs"); switch($rc) { case "400": echo "400 => Parametros Invalidos\n"; break; case "401": echo "401 => Erro de autenticação da API\n"; break; case "200": echo "200 => OK\n"; break; default: echo "Return Code: $rc\n"; } ?> |