MPI/API/CmdAdicionarFingerprint

De uTech Tecnologia
(Diferença entre revisões)
Ir para: navegação, pesquisa
(→‎Comando)
(→‎Comando)
 
(Uma edição intermediária de um usuário não apresentada)
Linha 23: Linha 23:
  
 
{| style="width: 100%; background-color: orange;"  
 
{| style="width: 100%; background-color: orange;"  
−
| '''NOTA''': Pelo menos, um dos parâmetros '''user''', '''card''', '''qrcode''', '''rfcode''' ou '''id''' '''DEVE''' ser enviado no comando para que a nova biometria lida, seja associada a um usuário já cadastrado.<BR>
+
| '''NOTA''': Pelo menos, um dos parâmetros '''user''' ou '''id''' '''DEVE''' ser enviado no comando para que a nova biometria lida, seja associada a um usuário já cadastrado.<BR>
 
|}
 
|}
  
Linha 29: Linha 29:
 
! 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"| user || Login do usuário, '''previamente configurado''' no comando [[MPI/API/CmdAdicionarUsuario|'''CmdAdicionarUsuario''']] - '''CAMPO MANDATÓRIO'''.
+
| align="left"| user || Login do usuário, '''previamente configurado''' no comando [[MPI/API/CmdAdicionarUsuario|'''CmdAdicionarUsuario''']].
 
|-
 
|-
 
| align="left"| card || Cartão NFC/Mifire do usuário, '''previamente configurado'' no comando [[MPI/API/CmdAdicionarUsuario|'''CmdAdicionarUsuario''']].
 
| align="left"| card || Cartão NFC/Mifire do usuário, '''previamente configurado'' no comando [[MPI/API/CmdAdicionarUsuario|'''CmdAdicionarUsuario''']].
Linha 79: Linha 79:
 
|}
 
|}
  
−
'''Passando comando com id '''user'''
 
−
{| class="wikitable"
 
−
! style="text-align: left; font-weight: bold;" | <pre>POST /?request=finger&state=on HTTP/1.1
 
−
Content-Type: application/json
 
−
Content-Length: 167
 
−
 
−
{
 
−
"id":"10",
 
−
"finger": "A"
 
−
}
 
−
</pre>
 
−
|}
 
  
  

Edição atual tal como 12h48min de 11 de junho de 2024

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

[editar] Comando


MÉTODO: POST

Parâmetros enviados para o Porteiro
request finger
state
  • On: Indica para o porteiro iniciar o processo de leitura da biometria.
  • Off: Indica para o porteiro parar/cancelar o processo de leitura da biometria (Enviar valor 'off' caso deseja cancelar a processo cadastro da biomnetria)

POST-DATA:


NOTA: Pelo menos, um dos parâmetros user ou id DEVE ser enviado no comando para que a nova biometria lida, seja associada a um usuário já cadastrado.
Parâmetros enviados para o Porteiro via JSON
user Login do usuário, previamente configurado no comando CmdAdicionarUsuario.
card Cartão NFC/Mifire do usuário, 'previamente configurado no comando CmdAdicionarUsuario.
qrcode QR Code do usuário, 'previamente configurado no comando CmdAdicionarUsuario.
frcode Código RF do usuário, 'previamente configurado no comando CmdAdicionarUsuario.
id id do usuário, listado nos comandos CmdCheckUser, CmdListarUsuarios ou CmdGetUser.
panic Define se o dedo cadastrado será para pânico ou não. Campo opcional. Padrão false.
  • false: Dedo cadastrado sem panico.
  • true: Dedo cadastrado como panico.
finger Identificação do dedo utilizado na biometria. Este campo DEVE ser utilizado com um dos campos de identificação acima. Este campo é opcional.

É utilizado uma letra para identificação do dedo:

  • 0: Dedo não definido.
  • A: Dedo polegar direito.
  • B: Dedo indicador direito.
  • C: Dedo médio direito.
  • D: Dedo anelar direito.
  • E: Dedo mínimo direito.
  • F: Dedo polegar esquerdo.
  • G: Dedo indicador esquerdo.
  • H: Dedo médio esquerdo.
  • I: Dedo anelar esquerdo.
  • J: Dedo mínimo esquerdo.


NOTA: Pelo menos, um dos parâmetros user, card, qrcode, rfcode ou id DEVE ser enviado no comando para que a nova biometria lida, seja associada a um usuário já cadastrado.



[editar] Exemplo

Passando comando com parâmetro user 

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

{
 "user":"1005",
 "finger": "A"
}


Resposta:

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




[editar] 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

Obtida de "https://wiki.utech.com.br/wiki/index.php?title=MPI/API/CmdAdicionarFingerprint&oldid=10271"
Ferramentas pessoais
Espaços nominais

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