MPI/API/CmdAdicionarUsuarioAuto
De uTech Tecnologia
(Diferença entre revisões)
(→Comando) |
|||
| Linha 2: | Linha 2: | ||
__TOC__ | __TOC__ | ||
| − | O comando '''Adicionar usuário automaticamente''' é enviado para o porteiro solicitando a inclusão automática de um novo usuário. Será inserido automaticamente um usuário com os dados do próximo cartão ou QR Code lido pelo porteiro. | + | O comando '''Adicionar usuário automaticamente''' é enviado para o porteiro solicitando a inclusão automática de um novo usuário. Será inserido automaticamente um usuário com os dados do próximo cartão ou QR Code lido pelo porteiro.<BR> |
| + | Se informado, no comando um dos parâmetros '''id''', '''user''', '''card''', '''qrcode''', '''rfcode''' ou '''fingerprint''', de um usuário já cadastrado, a TAG lida será adicionada neste usuário. | ||
== Comando == | == Comando == | ||
Edição de 13h24min de 5 de fevereiro de 2020
Tabela de conteúdo |
O comando Adicionar usuário automaticamente é enviado para o porteiro solicitando a inclusão automática de um novo usuário. Será inserido automaticamente um usuário com os dados do próximo cartão ou QR Code lido pelo porteiro.
Se informado, no comando um dos parâmetros id, user, card, qrcode, rfcode ou fingerprint, de um usuário já cadastrado, a TAG lida será adicionada neste usuário.
Comando
MÉTODO: GET
| Parâmetros enviados para o Porteiro | |
|---|---|
| request | probeuser |
| interface | Interface onde será lido o Cartão/QR Code.
|
| state | Define se é para habilitar ou desabilitar a leitura e inclusão.
|
POST-DATA:
| NOTA: Pelo menos, um dos parâmetros user, card, qrcode, rfcode, fingerprint ou id DEVE ser enviado no comando para que o porteiro identifique qual usuário está sendo lido/associada. Caso não seja passado nenhum valor neste campo, será inserido um novo usuário com o cartão ou QR Code lido. |
| Parâmetros enviados para o Porteiro via JSON | |
|---|---|
| id | id do usuário, listado nos comandos CmdCheckUser, CmdListarUsuarios ou CmdGetUser. |
| 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. |
| rfcode | Código RF do usuário, previamente configurado no comando CmdAdicionarUsuario. |
| fingerprint | Identificação/template da identificação biométrica. |
Exemplo
- Sem dados de usuários: (Inserindo novo usuário)
http://ip:porta/?request=probeuser&state=on |
|---|
- Com dados do usuário (Inserindo um cartão/QR code em um usuário já castrado)
POST/? request=probeuser&interface=1&state=on HTTP/1.1
Content-Type: application/json
Content-Length:
{
"user":"1000"
}
|
|---|
Resposta:
- 400 => Parâmetros incorretos
- 401 => Erro de autenticação da API
- 500 => Falha no comando
- 200 => OK
PHP
Exemplo sem selecionar usuário
<?php $user = "utech"; $pass = "1234"; $port = "8080"; $ipaddr = "10.0.0.1"; $url = ""; $url = "$ipaddr:$port?request=probeuser&state=on"; $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC); curl_setopt($ch, CURLOPT_USERPWD, "$user:$pass"); $result = curl_exec($ch); if(!$result) { echo "error!\n"; return 2; } $fs = preg_replace("/<html><body>/", "", "$result"); $rc = preg_replace("/<\/body><\/html>/", "", "$fs"); echo "Return Status:[$rc]\n"; ?> |
Exemplo selecionando o usuário
<?php $user = "utech"; $pass = "1234"; $port = "8080"; $ipaddr = "10.0.0.1"; $data = array( "user" => "1005" ); $url = ""; $url = "$ipaddr:$port?request=probeuser&interface=1&state=on"; $ch = curl_init($url); $data_string = json_encode($data); 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"); echo "Return Status:[$rc]\n"; ?> |
