MLW/API/CmdListarUsuarios
De uTech Tecnologia
Tabela de conteúdo |
O comando Lista Usuários utilizado para buscar a lista de usuários cadastrados no leitor.
Comando
MÉTODO: GET
Parâmetros enviados para o Leitor | |
---|---|
request | users |
Resposta enviada pelo o Leitor | |
---|---|
id | ID do usuário |
name | Nome do contato cadastrado |
user | Login do usuário cadastrado (somente números). |
password | Senha do usuário cadastrado (somente números). |
card | Identificação de acesso via cartão MIFARE / NFC |
rfcode | Identificação de acesso via RF433 - Controle |
perm1 | Permissão de acesso 1 - Veja mais sobre as permissões no link: MLI/PermissõesDeAcesso |
perm2 | Permissão de acesso 2 - Veja mais sobre as permissões no link: MLI/PermissõesDeAcesso |
perm3 | Permissão de acesso 3 - Veja mais sobre as permissões no link: MLI/PermissõesDeAcesso |
perm4 | Permissão de acesso 4 - Veja mais sobre as permissões no link: MLI/PermissõesDeAcesso |
perm5 | Permissão de acesso 5 - Veja mais sobre as permissões no link: MLI/PermissõesDeAcesso |
lifecount | Define a quantidade de vezes que o usuário terá o acesso liberado no leitor. Depois de N vezes, o usuário será automaticamente removido. O Valor zero (0) define como ilimitado. |
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 Configurações ⇒ Interface 1 e 2.
|
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.
|
key | Permite cadastrar a chave primária do integrador para manipulação de usuários. |
administrator | Define se o usuário terá permissões de administrados. Usuário administrador poderá utilizar funções de configurações da placa, como inserir novos usuários.
|
visitor | Identifica se o usuário é visitante ou não. Necessário definir uma data de validade para o visitante em Permissões de Acesso, configurando os campos perm1, perm2, perm3, perm4 e perm5.
|
interface | Mascara de 4 bits indicando quais interfaces (1 a 4) o usuário tem acesso. Valor em hexadecimal. 0 a F.
Exemplo: Se o usuário tiver acesso as interfaces 1 e 3, o valor seria 5. Caso o usuário tenha acesso a todas as interfaces (1, 2, 3 e 4), o valor seria f. |
Exemplo
http://ip:porta/?request=users |
---|
Resposta:
- 400 => Parâmetros incorretos
- 401 => Erro de autenticação da API
- 200 => OK
Content-Type: application/json [ { "id":"0", "name":"Marcos", "user":"", "password":"", "card":"1234567890", "rfcode":"1234567890", "lifecount":"0", "accessibility":"false", "panic":"false", "key":"", "administrator":"false", "visitor":"false", "interface":"f", "perm1":"", "perm2":"", "perm3":"", "perm4":"", "perm5":"" }, { "id":"1", "name":"Jose", "user":"", "password":"", "card":"0987654321", "rfcode":"0987654321", "lifecount":"0", "accessibility":"false", "panic":"false", "key":"", "administrator":"false", "visitor":"false", "interface":"1", "perm1":"", "perm2":"", "perm3":"", "perm4":"", "perm5":"" } ] |
---|
PHP
<?php $user = "utech"; $pass = "1234"; $port = "8080"; $ipaddr = "10.0.0.1"; $url = ""; $url = "$ipaddr:$port?request=users"; $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; } print_r(json_decode($result, true)); ?> |