MCI/API/CmdAdicionarUsuario

De uTech Tecnologia
Ir para: navegação, pesquisa

Tabela de conteúdo


O comando Adicionar usuário é utilizado inserir um usuário no controle de acesso da catraca

Comando


MÉTODO: POST

Parâmetros enviados para a Catraca
request adduser

POST-DATA:

Parâmetros enviados para a Catraca 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
fingerprint Identificação de acesso via biometria
validity Tempo em segundos para expirar as permissões do usuário (0 - Desabilitado)
lifecount Define a quantidade de vezes que o usuário terá o acesso liberado na catraca. 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 - Geral.
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 tem permissão de administrador. Usuário com permissão de administrado poderá gerenciar a catraca via API ou aplicativo EasyKey.
  • true: Usuário tem permissão de administrador.
  • false: Usuário não tem permissão de administrador.
email Endereço de e-mail do usuário. Utilizado para envio de notificações. Ver menu Notificações
apn Código de integração para push notification para iOS (Apple).
fcm Código de integração para push notification para Android (Google).
visitor Define se o novo usuário é um visitante.
  • true: Usuário é visitante.
  • false: Usuário não é visitante.
NOTA: Ao selecionar o usuário como visitante (true) DEVE-SE configurar as permissões de acesso com DATA e HORA. em um dos campos perm1, perm2, perm3, perm4 ou perm5. Após expirado o prazo para de validade do usuário (DATA/HORA), o usuário será automaticamente removido da base de usuários da catraca.
perm1 Permissão de acesso 1 - Veja mais sobre as permissões no link: MPI/PermissõesDeAcesso
perm2 Permissão de acesso 2 - Veja mais sobre as permissões no link: MPI/PermissõesDeAcesso
perm3 Permissão de acesso 3 - Veja mais sobre as permissões no link: MPI/PermissõesDeAcesso
perm4 Permissão de acesso 4 - Veja mais sobre as permissões no link: MPI/PermissõesDeAcesso
perm5 Permissão de acesso 5 - Veja mais sobre as permissões no link: MPI/PermissõesDeAcesso
finger Identificação do dedo utilizado na biometria. Este campo DEVE. É utilizado uma letra para identificação do dedo:
  • 0: Dedo não definido.
  • A: Dedo polegar direito.
  • B: Dedo indicador direito.
  • C: Dedo médio direito.
  • D: Dedo anelar direito.
  • E: Dedo mínimo direito.
  • F: Dedo polegar esquerdo.
  • G: Dedo indicador esquerdo.
  • H: Dedo médio esquerdo.
  • I: Dedo anelar esquerdo.
  • J: Dedo mínimo esquerdo.


Resposta:

A resposta será um JSON com o id da base da Catraca e com a chave primária (key) enviada no comando, conforme mostrado abaixo:
{"id":"1","key":"26ab0d"}

Exemplo

Envio: 

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",
 "administrator":"false",
 "email":"  ",
 "apn":"",
 "fcm":"",
 "visitor":"true,
 "perm1":"2019/4/17-2019/4/19 8:0-18:0"
}

Resposta: 


HTTP/1.1 200 OK
Content-Length: 25
Content-Type: application/json; charset=iso-8859-1
Date: Wed, 03 Jan 2007 21:52:54 GMT

{"id":"1","key":"26ab0d"}

Return code:

  • 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",
    "administrator" => "false",
    "email"         => "test@exemplo.com",
    "apn"           => "",
    "fcm"           => "",
    "visitor"       => "false",
    "perm1"         => "2019/4/17-2019/4/19 8:0-18:0"
);
 
$data_string = json_encode($data,JSON_UNESCAPED_SLASHES);
$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

Obtida de "https://wiki.utech.com.br/wiki/index.php?title=MCI/API/CmdAdicionarUsuario&oldid=8865"
Ferramentas pessoais
Espaços nominais

Variantes
Visualizações
Ações
Navegação
Ferramentas