MLW/API/CmdRemoverUsuario
De uTech Tecnologia
(Diferença entre revisões)
(Criou página com ' __TOC__ O comando '''Remover usuário''' é utilizado remover um usuário no controle de acesso do leitor. Como parâmetro de remoção, pode ser utilizado um dos parâmetro...') |
(→Exemplo) |
||
(2 edições intermediárias de um usuário não apresentadas) | |||
Linha 21: | Linha 21: | ||
'''POST-DATA:''' | '''POST-DATA:''' | ||
− | {| class="wikitable" width=" | + | {| class="wikitable" width="75%" |
! align="center" colspan="2" | Parâmetros enviados para o Leitor via JSON | ! align="center" colspan="2" | Parâmetros enviados para o Leitor via JSON | ||
|- | |- | ||
Linha 28: | Linha 28: | ||
| align="left"| user || login do usuário. Tamanho máximo 20 caracteres. | | align="left"| user || login do usuário. Tamanho máximo 20 caracteres. | ||
|- | |- | ||
− | | align="left"| card || Identificação de acesso via cartão '''MIFARE / NFC'''. Tamanho máximo 32 caracteres. | + | | align="left"| <del>card</del> || <del>Identificação de acesso via cartão '''MIFARE / NFC'''. Tamanho máximo 32 caracteres.</del>. <span style="color:#ff0000">Removido na versão 1.1.10</span> |
|- | |- | ||
− | | align="left"| rfcode || Identificação de acesso via '''RF 433''' (Controle). Tamanho máximo 16 caracteres. | + | | align="left"| <del>rfcode</del> || <del>Identificação de acesso via '''RF 433''' (Controle). Tamanho máximo 16 caracteres.</del>. <span style="color:#ff0000">Removido na versão 1.1.10</span> |
|- | |- | ||
| align="left"| key || '''Chave Primária do Integrador''', configurada/adicionada na inclusão do usuário (campo disponível somente via API). Tamanho máximo 16 caracteres. | | align="left"| key || '''Chave Primária do Integrador''', configurada/adicionada na inclusão do usuário (campo disponível somente via API). Tamanho máximo 16 caracteres. | ||
Linha 55: | Linha 55: | ||
|} | |} | ||
− | '''Ou removendo pelo | + | '''Ou removendo pelo id:''' |
{| class="wikitable" | {| class="wikitable" | ||
! style="text-align: left; font-weight: bold;" | <pre>POST /?request=deluser HTTP/1.1 | ! style="text-align: left; font-weight: bold;" | <pre>POST /?request=deluser HTTP/1.1 | ||
Linha 63: | Linha 63: | ||
Content-Length: 167 | Content-Length: 167 | ||
− | {" | + | {"id":"1"} |
</pre> | </pre> | ||
|} | |} | ||
Linha 102: | Linha 102: | ||
$data = array("user" => "1005"); | $data = array("user" => "1005"); | ||
+ | |||
$data_string = json_encode($data); | $data_string = json_encode($data); | ||
$url = "$ipaddr:$port?request=deluser"; | $url = "$ipaddr:$port?request=deluser"; | ||
Linha 114: | Linha 115: | ||
'Content-Length: ' . strlen($data_string)) | 'Content-Length: ' . strlen($data_string)) | ||
); | ); | ||
− | + | ||
$result = curl_exec($ch); | $result = curl_exec($ch); | ||
− | if( | + | if(curl_errno($ch)){ |
− | echo | + | echo 'Curl error: ' . curl_error($ch) . "\n"; |
return 2; | return 2; | ||
} | } | ||
− | + | ||
− | $ | + | $rc = curl_getinfo($ch, CURLINFO_HTTP_CODE); |
− | + | ||
switch($rc) { | switch($rc) { | ||
− | + | ||
case "401": | case "401": | ||
echo "401 => Parametros Invalidos\n"; | echo "401 => Parametros Invalidos\n"; | ||
break; | break; | ||
− | + | ||
case "500": | case "500": | ||
echo "500 => Falha no comando\n"; | echo "500 => Falha no comando\n"; | ||
break; | break; | ||
− | + | ||
case "200": | case "200": | ||
echo "200 => OK\n"; | echo "200 => OK\n"; | ||
break; | break; | ||
− | + | ||
default: | default: | ||
echo "Return Code: $rc\n"; | echo "Return Code: $rc\n"; | ||
} | } | ||
− | + | ||
?> | ?> | ||
</source> | </source> |
Edição atual tal como 18h38min de 10 de outubro de 2024
Tabela de conteúdo |
O comando Remover usuário é utilizado remover um usuário no controle de acesso do leitor. Como parâmetro de remoção, pode ser utilizado um dos parâmetros listados abaixo).
|
[editar] Comando
MÉTODO: POST
Parâmetros enviados para o Leitor | |
---|---|
request | deluser |
POST-DATA:
Parâmetros enviados para o Leitor via JSON | |
---|---|
id | ID do usuário. Valor inteiro de 0 a 65535. |
user | login do usuário. Tamanho máximo 20 caracteres. |
|
|
|
|
key | Chave Primária do Integrador, configurada/adicionada na inclusão do usuário (campo disponível somente via API). Tamanho máximo 16 caracteres. |
Ao enviar o comando deluser com o parâmetro key, todos usuários com a mesma chave primária (key) serão removidos. |
[editar] Exemplo
Removendo pelo usuário:
POST /?request=deluser HTTP/1.1 Host: 10.0.0.1:8080 Accept: */* Content-Type: application/json Content-Length: 167 {"user":"1005"} |
---|
Ou removendo pelo id:
POST /?request=deluser HTTP/1.1 Host: 10.0.0.1:8080 Accept: */* Content-Type: application/json Content-Length: 167 {"id":"1"} |
---|
Ou removendo TODOS usuários com a mesma chave primária.
POST /?request=deluser HTTP/1.1 Host: 10.0.0.1:8080 Accept: */* Content-Type: application/json Content-Length: 167 {"key":"2eed56b6asea453fe7"} |
---|
Resposta:
- 400 => Parâmetros incorretos
- 401 => Erro de autenticação da API
- 500 => Falha no comando
- 200 => OK
[editar] PHP
<?php $user = "utech"; $pass = "1234"; $port = "8080"; $ipaddr = "10.0.0.1"; $data = array("user" => "1005"); $data_string = json_encode($data); $url = "$ipaddr:$port?request=deluser"; $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(curl_errno($ch)){ echo 'Curl error: ' . curl_error($ch) . "\n"; return 2; } $rc = curl_getinfo($ch, CURLINFO_HTTP_CODE); switch($rc) { case "401": echo "401 => Parametros Invalidos\n"; break; case "500": echo "500 => Falha no comando\n"; break; case "200": echo "200 => OK\n"; break; default: echo "Return Code: $rc\n"; } ?> |