MLI/API/CmdAdicionarUsuario
De uTech Tecnologia
(Diferença entre revisões)
| Linha 58: | Linha 58: | ||
| align="left"| key || Permite cadastrar a '''chave primária''' do integrador para manipulação de usuários. | | align="left"| key || Permite cadastrar a '''chave primária''' do integrador para manipulação de usuários. | ||
|} | |} | ||
| + | |||
| + | |||
| + | '''Resposta:''' | ||
| + | |||
| + | A resposta será um '''JSON''' com o '''id''' da base do Porteiro e com a chave primária ('''key''') enviada no comando, conforme mostrado abaixo: | ||
| + | <BR> | ||
| + | '''{"id":"1","key":"26ab0d"} | ||
| + | <BR> | ||
== Exemplo == | == Exemplo == | ||
| Linha 80: | Linha 88: | ||
</pre> | </pre> | ||
|} | |} | ||
| + | |||
'''Resposta:''' | '''Resposta:''' | ||
| + | |||
| + | |||
| + | {| class="wikitable" | ||
| + | ! style="text-align: left; font-weight: bold;" | <pre> | ||
| + | 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"} | ||
| + | </pre> | ||
| + | |} | ||
| + | |||
| + | '''Return code:''' | ||
* '''400''' => Parâmetros incorretos | * '''400''' => Parâmetros incorretos | ||
Edição de 17h02min de 29 de março de 2019
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. |
Resposta:
A resposta será um JSON com o id da base do Porteiro e com a chave primária (key) enviada no comando, conforme mostrado abaixo:
{"id":"1","key":"26ab0d"}
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"
}
|
|---|
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" ); $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"; } ?> |
