MII/API/CmdAdicionarFingerprint

De uTech Tecnologia
Ir para: navegação, pesquisa

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 intercomunicador

Comando


MÉTODO: POST

Parâmetros enviados para o intercomunicador
request finger
state
  • On: Indica para o intercomunicador iniciar o processo de leitura da biometria.
  • Off: Indica para o intercomunicador 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, card, qrcode, rfcode 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 intercomunicador via JSON
user Login do usuário, previamente configurado no comando CmdAdicionarUsuario - CAMPO MANDATÓRIO.
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.



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"
}

Passando comando com id user

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

{
 "id":"10",
 "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




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