MPI/API/CmdAdicionarFingerprint

De uTech Tecnologia
(Diferença entre revisões)
Ir para: navegação, pesquisa
(Criou página com ' __TOC__ O comando '''Adicionar usuário''' é utilizado inserir um usuário no controle de acesso do porteiro == Comando == <BR\> '''MÉTODO:''' <span style="color:red">''...')
 
Linha 2: Linha 2:
 
__TOC__
 
__TOC__
  
O comando '''Adicionar usuário''' é utilizado inserir um usuário no controle de acesso do porteiro
+
O comando '''Cadastrar Biometria''' é utilizado para ler e cadastrar a biometria de uma um usuário no controle de acesso do porteiro
  
 
== Comando ==
 
== Comando ==
Linha 12: Linha 12:
 
! align="center" colspan="2" | Parâmetros enviados para o Porteiro
 
! align="center" colspan="2" | Parâmetros enviados para o Porteiro
 
|-
 
|-
| align="left"| '''request''' || '''adduser'''
+
| align="left"| '''request''' || '''finger'''
 +
|-
 +
| align="left"| '''request''' ||
 +
* '''On''': Indica para o porteiro para iniciar o processo de leitura da biometria.
 +
* '''Off''': Indica para o porteiro para iniciar o processo de leitura da biometria.
 
|}
 
|}
  
Linha 20: Linha 24:
 
! align="center" colspan="2" | Parâmetros enviados para o Porteiro via JSON
 
! align="center" colspan="2" | Parâmetros enviados para o Porteiro via JSON
 
|-
 
|-
| align="left"| name || Nome do usuáio.
+
| align="left"| user || Login do usuário, '''previamente configurado''.
|-
+
| align="left"| user || Login do usuário.
+
|-
+
| align="left"| password || Senha do usuário.
+
|-
+
| align="left"| card || Identificação de acesso via cartão '''MIFARE / NFC'''
+
|-
+
| align="left"| qrcode || Identificação de acesso via '''QR Code'''
+
|-
+
| align="left"| rfcode || Identificação de acesso via '''RF 433''' (Controle)
+
|-
+
| align="left"| fingerprint || Identificação de acesso via '''biometria'''
+
|-
+
| align="left"| validity || Tempo em segundos para expirar as permissões do usuário (0 - Desabilitado)
+
|-
+
| align="left"| perm1 || Permissão de acesso 1 - Veja mais sobre as permissões no link: [[MPI/PermissõesDeAcesso]]
+
|-
+
| align="left"| perm2 || Permissão de acesso 2 - Veja mais sobre as permissões no link: [[MPI/PermissõesDeAcesso]]
+
|-
+
| align="left"| perm3 || Permissão de acesso 3 - Veja mais sobre as permissões no link: [[MPI/PermissõesDeAcesso]]
+
|-
+
| align="left"| perm4 || Permissão de acesso 4 - Veja mais sobre as permissões no link: [[MPI/PermissõesDeAcesso]]
+
|-
+
| align="left"| perm5 || Permissão de acesso 5 - Veja mais sobre as permissões no link: [[MPI/PermissõesDeAcesso]]
+
|-
+
| align="left"| lifecount || Define a quantidade de vezes que o usuário terá o acesso liberado no porteiro. Depois de N vezes, o usuário será automaticamente removido. O Valor zero (0) define como ilimitado.
+
|-
+
| align="left"| accessibility || Define que o usuário criado terá configurações de acessibilidade. Como por exemplo o tempo de acionamento da porta para acessibilidade. Ver docs. menu [[MPI/ConfiguracaoWEB#Submenu_Interface_1_.2F_Interface_2|'''Controle de Acesso - Interface 1/2''']].
+
|-
+
| align="left"| panic || Se habilitado, define que esse usuário é associado a função pânico. Toda vez que sua ''tag'', biometria, ''QR code'', etc..., for detectada, a função pânico será ativada.
+
|-
+
| align="left"| key || Permite cadastrar a '''chave primária''' do integrador para manipulação de usuários.
+
 
|}
 
|}
  
Linha 59: Linha 31:
  
 
{| class="wikitable"
 
{| class="wikitable"
! style="text-align: left; font-weight: bold;" | <pre>POST /?request=adduser HTTP/1.1
+
! style="text-align: left; font-weight: bold;" | <pre>POST /?request=finger&state=on HTTP/1.1
 
Content-Type: application/json
 
Content-Type: application/json
 
Content-Length: 167
 
Content-Length: 167
  
{"name":"Teste",
+
{
  "user":"1005",
+
  "user":"1005"
"password":"8989",
+
"card":"af23d66",
+
"qrcode":"b15c4",
+
"validity:":"0",
+
"lifecount":"0",
+
"accessibility":"false",
+
"panic":"false",
+
"key":"26ab0d"
+
 
}
 
}
 
</pre>
 
</pre>
Linha 81: Linha 45:
 
* '''400''' => Parâmetros incorretos
 
* '''400''' => Parâmetros incorretos
 
* '''401''' => Erro de autenticação da API
 
* '''401''' => Erro de autenticação da API
 +
* '''404''' => Usuário não encontrado
 
* '''500''' => Falha no comando
 
* '''500''' => Falha no comando
 
* '''200''' => OK
 
* '''200''' => OK
Linha 99: Linha 64:
  
 
$data array(
 
$data array(
    "name"      => "Arilson Gilberto da Costa",
+
     "user"      => "1005"
     "user"      => "1005",
+
    "password"  => "8989",
+
    "card"      => "af23d66529acbd",
+
    "qrcode"    => "b15c4c36b924645d023c2f13dec7a028",
+
    "validity:" => "0"
+
 
);
 
);
 
      
 
      
 
$data_string = json_encode($data);
 
$data_string = json_encode($data);
$url = "$ipaddr:$port?request=adduser";
+
$url = "$ipaddr:$port?request=finger&state=on";
 
$ch = curl_init($url);
 
$ch = curl_init($url);
 
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
 
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
Linha 134: Linha 94:
 
         echo "400 => Parametros Invalidos\n";
 
         echo "400 => Parametros Invalidos\n";
 
     break;
 
     break;
       
+
 
 
     case "401":
 
     case "401":
 
         echo "401 => Erro de autenticação da API\n";
 
         echo "401 => Erro de autenticação da API\n";
 +
    break;
 +
 +
    case "404":
 +
        echo "404 => Usuário não encontrado\n";
 
     break;
 
     break;
  

Edição de 12h46min de 30 de julho de 2018

Tabela de conteúdo


O comando Cadastrar Biometria é utilizado para ler e cadastrar a biometria de uma um usuário no controle de acesso do porteiro

Comando


MÉTODO: POST

Parâmetros enviados para o Porteiro
request finger
request
  • On: Indica para o porteiro para iniciar o processo de leitura da biometria.
  • Off: Indica para o porteiro para iniciar o processo de leitura da biometria.

POST-DATA:

Parâmetros enviados para o Porteiro via JSON
user Login do usuário, 'previamente configurado.

Exemplo

POST /?request=finger&state=on HTTP/1.1
Content-Type: application/json
Content-Length: 167

{
 "user":"1005"
}

Resposta:

  • 400 => Parâmetros incorretos
  • 401 => Erro de autenticação da API
  • 404 => Usuário não encontrado
  • 500 => Falha no comando
  • 200 => OK




PHP

<?php
 
$user = "utech";
$pass = "1234";
$port = "8080";
$ipaddr = "10.0.0.1";
 
$data array(
    "user"      => "1005"
);
 
$data_string = json_encode($data);
$url = "$ipaddr:$port?request=finger&state=on";
$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 "404":
        echo "404 => Usuário não encontrado\n";
    break;
 
    case "500":
        echo "500 => Falha no comando\n";
    break;
 
    case "200":
        echo "200 => OK\n";
    break;
 
    default:
        echo "Return Code: $rc\n";
}
 
?>




Voltar


Ferramentas pessoais
Espaços nominais

Variantes
Visualizações
Ações
Navegação
Ferramentas