MLW/API/CmdListarUsuarios
De uTech Tecnologia
(Diferença entre revisões)
(→Exemplo) |
|||
(8 edições intermediárias de um usuário não apresentadas) | |||
Linha 58: | Linha 58: | ||
* '''true''': É visitante. | * '''true''': É visitante. | ||
* '''false''': Não é visitante. | * '''false''': Não é visitante. | ||
+ | |- | ||
+ | | align="left"| interface || Mascara de 4 bits indicando quais interfaces (1 a 4) o usuário tem acesso. Valor em hexadecimal. 0 a F. | ||
+ | * '''bit 0''': Interface 1. | ||
+ | * '''bit 1''': Interface 2. | ||
+ | * '''bit 2''': Interface 3. | ||
+ | * '''bit 3''': Interface 4. | ||
+ | '''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'''. | ||
+ | |- | ||
+ | | align="left"| relay || Interface de acionamento do usuário. | ||
+ | * '''0''': Nenhuma. | ||
+ | * '''1''': Interface 1. | ||
+ | * '''2''': Interface 2. | ||
+ | * '''3''': Ambas (interface 1 e 2). | ||
|} | |} | ||
Linha 92: | Linha 105: | ||
"administrator":"false", | "administrator":"false", | ||
"visitor":"false", | "visitor":"false", | ||
− | |||
"interface":"f", | "interface":"f", | ||
"perm1":"", | "perm1":"", | ||
Linha 113: | Linha 125: | ||
"administrator":"false", | "administrator":"false", | ||
"visitor":"false", | "visitor":"false", | ||
− | |||
"interface":"1", | "interface":"1", | ||
"perm1":"", | "perm1":"", | ||
Linha 157: | Linha 168: | ||
<br/> | <br/> | ||
<br/> | <br/> | ||
− | [[ | + | [[MLW/API|'''Voltar''']] |
----- | ----- |
Edição atual tal como 17h58min de 22 de junho de 2022
Tabela de conteúdo |
O comando Lista Usuários utilizado para buscar a lista de usuários cadastrados no leitor.
[editar] 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. |
relay | Interface de acionamento do usuário.
|
[editar] 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":"" } ] |
---|
[editar] 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)); ?> |