MLI/API/CmdAdicionarUsuario

De uTech Tecnologia
(Diferença entre revisões)
Ir para: navegação, pesquisa
(Criou página com ' __TOC__ O comando '''Adicionar usuário''' é utilizado inserir um usuário no controle de acesso do leitor == Comando == <BR\> '''MÉTODO:''' <span style="color:red">'''P...')
 
Linha 10: Linha 10:
  
 
{| class="wikitable" width="65%"
 
{| class="wikitable" width="65%"
! align="center" colspan="2" | Parâmetros enviados para o Porteiro
+
! align="center" colspan="2" | Parâmetros enviados para o Leitor
 
|-
 
|-
 
| align="left"| '''request''' || '''adduser'''
 
| align="left"| '''request''' || '''adduser'''
Linha 18: Linha 18:
  
 
{| class="wikitable" width="65%"
 
{| class="wikitable" width="65%"
! align="center" colspan="2" | Parâmetros enviados para o Porteiro via JSON
+
! align="center" colspan="2" | Parâmetros enviados para o Leitor via JSON
 
|-
 
|-
 
| align="left"| name || Nome do usuário.
 
| align="left"| name || Nome do usuário.
Linha 36: Linha 36:
 
| align="left"| validity || Tempo em segundos para expirar as permissões do usuário (0 - Desabilitado)
 
| align="left"| validity || Tempo em segundos para expirar as permissões do usuário (0 - Desabilitado)
 
|-
 
|-
| align="left"| perm1 || Permissão de acesso 1 - Veja mais sobre as permissões no link: [[MPI/PermissõesDeAcesso]]
+
| align="left"| perm1 || Permissão de acesso 1 - Veja mais sobre as permissões no link: [[MLI/PermissõesDeAcesso]]
 
|-
 
|-
| align="left"| perm2 || Permissão de acesso 2 - Veja mais sobre as permissões no link: [[MPI/PermissõesDeAcesso]]
+
| align="left"| perm2 || Permissão de acesso 2 - Veja mais sobre as permissões no link: [[MLI/PermissõesDeAcesso]]
 
|-
 
|-
| align="left"| perm3 || Permissão de acesso 3 - Veja mais sobre as permissões no link: [[MPI/PermissõesDeAcesso]]
+
| align="left"| perm3 || Permissão de acesso 3 - Veja mais sobre as permissões no link: [[MLI/PermissõesDeAcesso]]
 
|-
 
|-
| align="left"| perm4 || Permissão de acesso 4 - Veja mais sobre as permissões no link: [[MPI/PermissõesDeAcesso]]
+
| align="left"| perm4 || Permissão de acesso 4 - Veja mais sobre as permissões no link: [[MLI/PermissõesDeAcesso]]
 
|-
 
|-
| align="left"| perm5 || Permissão de acesso 5 - Veja mais sobre as permissões no link: [[MPI/PermissõesDeAcesso]]
+
| align="left"| perm5 || Permissão de acesso 5 - Veja mais sobre as permissões no link: [[MLI/PermissõesDeAcesso]]
 
|-
 
|-
 
| align="left"| 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.
 
| align="left"| 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.
 
|-
 
|-
| align="left"| 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 [[MPI/ConfiguracaoWEB#Submenu_Interface_1_.2F_Interface_2|'''Controle de Acesso - Interface 1/2''']].
+
| align="left"| 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 [[MLI/ConfiguracaoWEB#Submenu_Interface_1_.2F_Interface_2|'''Controle de Acesso - Interface 1/2''']].
 
|-
 
|-
 
| align="left"| 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.
 
| align="left"| 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.
Linha 57: Linha 57:
 
* ''Bit 1''': Permissão de acesso a interface de acionamento 1 do leitor.
 
* ''Bit 1''': Permissão de acesso a interface de acionamento 1 do leitor.
 
* '''Bit 2''': Permissão de acesso a interface de acionamento 2 do leitor.
 
* '''Bit 2''': Permissão de acesso a interface de acionamento 2 do leitor.
* '''Bit 3 a 32:''' Permissão de acesso a interface externa . Leitor ou Porteiro ''slave''. Ver [[MPI/ConfiguracaoWEB#Leitores|Leitores Externos]]
+
* '''Bit 3 a 32:''' Permissão de acesso a interface externa . Leitor ou Leitor ''slave''. Ver [[MLI/ConfiguracaoWEB#Leitores|Leitores Externos]]
 
'''Exemplos:'''
 
'''Exemplos:'''
 
# '''00000001''' - Bit 1, acesso a interface de acionamento 1 do leitor.
 
# '''00000001''' - Bit 1, acesso a interface de acionamento 1 do leitor.
Linha 178: Linha 178:
 
<br/>
 
<br/>
 
<br/>
 
<br/>
[[MPI/API#Comandos|'''Voltar''']]
+
[[MLI/API#Comandos|'''Voltar''']]
 
-----
 
-----

Edição de 21h06min de 27 de setembro de 2018

Tabela de conteúdo


O comando Adicionar usuário é utilizado inserir um usuário no controle de acesso do leitor

Comando


MÉTODO: POST

Parâmetros enviados para o Leitor
request adduser

POST-DATA:

Parâmetros enviados para o Leitor via JSON
name Nome do usuário.
user Login do usuário.
password Senha do usuário.
card Identificação de acesso via cartão MIFARE / NFC
qrcode Identificação de acesso via QR Code
rfcode Identificação de acesso via RF 433 (Controle)
fingerprint Identificação de acesso via biometria
validity Tempo em segundos para expirar as permissões do usuário (0 - Desabilitado)
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 Controle de Acesso - Interface 1/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.
interface Mascara de 32 bits com permissão de acesso para o usuário.
  • Bit 1': Permissão de acesso a interface de acionamento 1 do leitor.
  • Bit 2: Permissão de acesso a interface de acionamento 2 do leitor.
  • Bit 3 a 32: Permissão de acesso a interface externa . Leitor ou Leitor slave. Ver Leitores Externos

Exemplos:

  1. 00000001 - Bit 1, acesso a interface de acionamento 1 do leitor.
  2. 00000002 - Bit 1, acesso a interface de acionamento 2 do leitor.
  3. 00000003 - Bit's 1 e 2, acesso a interface de acionamento 1 e 2 do leitor.
  4. 0000007F - Bit's 1, 2, 3, 4, 5, 6 e 7, acesso a interface de acionamento 1 e 2 do leitor e interfaces , 4, 5, 6 e 7 de leitores externos.
NOTA1: Se o valor for 0 (zero), o usuário tem permissão para TODAS as interfaces.

NOTA2: Valores em base 16 - hexadecimal.

Exemplo

POST /?request=adduser HTTP/1.1
Content-Type: application/json
Content-Length: 167

{"name":"Teste",
 "user":"1005",
 "password":"8989",
 "card":"af23d66",
 "qrcode":"b15c4",
 "validity:":"0",
 "lifecount":"0",
 "accessibility":"false",
 "panic":"false",
 "key":"26ab0d",
 "interface": "0000007f"
}

Resposta:

  • 400 => Parâmetros incorretos
  • 401 => Erro de autenticação da API
  • 500 => Falha no comando
  • 200 => OK




PHP

<?php
 
$user = "utech";
$pass = "1234";
$port = "8080";
$ipaddr = "10.0.0.1";
 
$data = array(
    "name"          => "Arilson Gilberto da Costa",
    "user"          => "1005",
    "password"      => "8989",
    "card"          => "af23d66529acbd",
    "qrcode"        => "b15c4c36b924645d023c2f13dec7a028",
    "validity:"     => "0",
    "lifecount"     => "0",
    "accessibility" => "false",
    "panic"         => "false",
    "key"           => "26ab0d",
    "interface"     => "0000007f"
);
 
$data_string = json_encode($data);
$url = "$ipaddr:$port?request=adduser";
$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 "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