MCP/API/CmdAdicionarFingerprint
De uTech Tecnologia
(Diferença entre revisões)
(→Comando) |
(→Comando) |
||
| Linha 24: | Linha 24: | ||
{| style="width: 100%; background-color: orange;" | {| style="width: 100%; background-color: orange;" | ||
| − | |Necessário | + | |Necessário, pelo menos, um dos parâmetros '''id''' ou '''user'''. Utilizado para identificar o usuário que será cadastrado a nova biometria. |
|} | |} | ||
Edição atual tal como 13h21min 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 da central MCP. A leitura da biometria é realizada por Leitores externos do MCP, que podem ser Leitores MLI ou Porteiros MPI
[editar] Comando
MÉTODO: POST
| Parâmetros enviados para a central MCP | |
|---|---|
| request | finger |
| state |
|
| interface | ID/Identificação do leitor externo (5 a 32). (Ver Leitores) |
POST-DATA:
| Necessário, pelo menos, um dos parâmetros id ou user. Utilizado para identificar o usuário que será cadastrado a nova biometria. |
| Parâmetros enviados para a central MCP via JSON | |
|---|---|
| user | Login do usuário, previamente configurado no comando CmdAdicionarUsuario. |
| id | id do usuário, listado nos comandos CmdCheckUser, CmdListarUsuarios ou CmdGetUser. |
| card | Cartão Mifire/NFC de identificação do usuário. |
| qrcode | QR Code de identificação do usuário. |
| rfcode | RF Code de identificação do usuário. |
| vcard | Identificação do cartão veicular. |
| finger | Identificação do dedo utilizado na biometria. Este campo DEVE ser utilizado com um dos campos de identificação acima. É utilizado uma letra para identificação do dedo:
|
[editar] Exemplo
POST /?request=finger&state=on&interface=5 HTTP/1.1
Content-Type: application/json
Content-Length: 167
{
"user":"1005"
}
|
|---|
Ou
POST /?request=finger&state=on&interface=5 HTTP/1.1
Content-Type: application/json
Content-Length: 167
{
"user":"1005",
"finter': "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 (Leitura iniciada)
[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&interface=5"; $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"; } ?> |
