Cadastro De Usuarios

Cadastrar Múltiplos Usuários (V2)

Por meio da chamada abaixo é realizado o cadastro de uma lista de usuários. Sendo possível realizar o cadastro de até 10 usuários na mesma chamada.

ℹ️

Observação: Para o cadastro de um usuário a mesma chamada pode ser utilizada, passando apenas um usuário na lista.

Requisição - POST

http://192.168.1.201/cgi-bin/AccessUser.cgi?action=insertMulti

Body - application/json

  {
    "UserList": [
      {
        "UserID": "5",
        "UserName": "test",
        "UserType": 0,
        "Authority": 1,
        "Password": "234",
        "Doors": [
          0,
          1,
          2,
          3
        ],
        "TimeSections": [
          255,
          255,
          255,
          255
        ],
        "ValidFrom": "2019-01-02 00:00:00",
        "ValidTo": "2037-01-02 01:00:00"
      },
      {
        "UserID": "6",
        "UserName": "test",
        "UserType": 0,
        "Password": "234",
        "Doors": [
          0,
          1
        ],
        "TimeSections": [
          255,
          255
        ],
        "SpecialDaysSchedule": [
          255,
          255
        ],
        "ValidFrom": "2019-01-02 00:00:00",
        "ValidTo": "2037-01-02 01:00:00"
      },
      {
        "UserID": "7",
        "UserName": "test",
        "UserType": 0,
        "UserStatus": 0,
        "Password": "234",
        "Doors": [
          2,
          3
        ],
        "TimeSections": [
          255,
          255
        ],
        "ValidFrom": "2019-01-02 00:00:00",
        "ValidTo": "2037-01-02 01:00:00"
      },
      {
        "UserID": "8",
        "UserName": "test",
        "UserType": 0,
        "UserStatus": 0,
        "Password": "234",
        "Doors": [
          0,
          2,
          3
        ],
        "TimeSections": [
          255,
          255,
          255
        ],
        "ValidFrom": "2019-01-02 00:00:00",
        "ValidTo": "2037-01-02 01:00:00"
      }
    ]
  }

param	type	description
`UserID` *	String	ID do Usuário, exemplo: `16`. É recomendado a utilização de valores em decimal de até 30 digitos
`UserName` *	String	Nome do Usuário, exemplo: `Alexandre`
`UserType` *	Number	Tipo de usuário, sendo `0: General user`, `2: Guest user`
`UseTime` *	Number	Limite de acessos válidos, necessário ser um usuário do tipo visitante ( `2: Guest user`)
`Password`	Number	Senha de Acesso do Usuário, exemplo: `878485`
`Authority`	Number	Define se o usuário será administrador ou não, sendo `1` administrador e `2` usuário normal
`Doors`	Number	Portas que o usuário irá possuir acesso, sendo necessário quando cadastrado um TimeSections ao usuário. Esses valores podem ser `0` para porta 1, `1` para porta 2, `2` para porta 3, `3` para porta 4
`TimeSections`	Number	Zona de tempo de acesso do usuário, padrão: `255`
`ValidFrom`*	String	Data de Inicio de Validade, Exemplo: `2019-01-02 00:00:00`
`ValidTo`*	String	Data de Final de Validade, Exemplo: `2037-01-02 01:00:00`

Exemplo de Retorno - text/plain

OK

Exemplos

import requests
 
url = "http://192.168.1.201/cgi-bin/AccessUser.cgi?action=insertMulti"
 
json_data = {
    "UserList": [
        {
            "UserID": "5",
            "UserName": "test",
            "UserType": 0,
            "Authority": 1,
            "Password": "234",
            "Doors": [0,1,2,3],
            "TimeSections": [255,255,255,255],
            "ValidFrom": "2019-01-02 00:00:00",
            "ValidTo": "2037-01-02 01:00:00"
        },
        {
            "UserID": "6",
            "UserName": "test",
            "UserType": 0,
            "Password": "234",
            "Doors": [0,1],
            "TimeSections": [255,255],
            "SpecialDaysSchedule": [255,255,255,255],
            "ValidFrom": "2019-01-02 00:00:00",
            "ValidTo": "2037-01-02 01:00:00"
        },
        {
            "UserID": "7",
            "UserName": "test",
            "UserType": 0,
            "UserStatus": 0,
            "Password": "234",
            "Doors": [2,3],
            "TimeSections": [255,255],
            "ValidFrom": "2019-01-02 00:00:00",
            "ValidTo": "2037-01-02 01:00:00"
        },
        {
            "UserID": "8",
            "UserName": "test",
            "UserType": 0,
            "UserStatus": 0,
            "Password": "234",
            "Doors": [0,2,3],
            "TimeSections": [255,255,255],
            "ValidFrom": "2019-01-02 00:00:00",
            "ValidTo": "2037-01-02 01:00:00"
        }
    ]
}
username = "admin"
password = "admin123"
 
def send_user(url, json_data, username, password):
    # Realiza a requisição HTTP POST com autenticação digest
    response = requests.post(url, auth=requests.auth.HTTPDigestAuth(username, password), json=json_data)
    # Retorna o status code e o conteúdo da resposta
    return response.status_code, response.content
 
status_code, response_content = send_user(url, json_data, username, password)
 
print("Status Code:", status_code)
print("Response Content:", response_content)

Atualizar Múltiplos Usuários (V2)

Por meio da chamada abaixo é realizar o atualização de múltiplos e único usuário em uma chamada. Sendo possível realizar o cadastro de até 10 usuários na mesma chamada.

Requisição - POST

http://192.168.1.201/cgi-bin/AccessUser.cgi?action=updateMulti

Body - application/json

  {
    "UserList": [
      {
        "UserID": "5",
        "UserName": "test",
        "UserType": 0,
        "Authority": 1,
        "Password": "234",
        "Doors": [
          0,
          1,
          2
        ],
        "TimeSections": [
          255,
          255,
          255
        ],
        "ValidFrom": "2019-01-02 00:00:00",
        "ValidTo": "2037-01-02 01:00:00"
      },
      {
        "UserID": "6",
        "UserName": "test",
        "UserType": 0,
        "Password": "234",
        "Doors": [
          0,
          3
        ],
        "TimeSections": [
          255,
          255
        ],
        "SpecialDaysSchedule": [
          255,
          255
        ],
        "ValidFrom": "2019-01-02 00:00:00",
        "ValidTo": "2037-01-02 01:00:00"
      },
      {
        "UserID": "7",
        "UserName": "test",
        "UserType": 0,
        "UserStatus": 0,
        "Password": "234",
        "Doors": [
          0
        ],
        "TimeSections": [
          255
        ],
        "ValidFrom": "2019-01-02 00:00:00",
        "ValidTo": "2037-01-02 01:00:00"
      },
      {
        "UserID": "8",
        "UserName": "test",
        "UserType": 0,
        "UserStatus": 0,
        "Password": "234",
        "Doors": [
          3
        ],
        "TimeSections": [
          255
        ],
        "ValidFrom": "2019-01-02 00:00:00",
        "ValidTo": "2037-01-02 01:00:00"
      }
    ]
  }

param	type	description
`UserID` *	String	ID do Usuário, exemplo: `16`. É possível também realizar o cadastro de um valor em Hexadecimal
`UserName` *	String	Nome do Usuário, exemplo: `Alexandre`
`UserType` *	Number	Tipo de usuário, sendo `0: General user`, `2: Guest user`
`Password`	Number	Senha de Acesso do Usuário, exemplo: `878485`
`Authority`	Number	Define se o usuário será administrador ou não, sendo `1` administrador e `2` usuário normal
`Doors`	Number	Portas que o usuário irá possuir acesso, sendo necessário quando cadastrado um TimeSections ao usuário. Esses valores podem ser `0` para porta 1, `1` para porta 2, `2` para porta 3, `3` para porta 4
`TimeSections`	Number	Zona de tempo de acesso do usuário, padrão: `255`
`ValidFrom`*	String	Data de Inicio de Validade, Exemplo: `2019-01-02 00:00:00`
`ValidTo`*	String	Data de Final de Validade, Exemplo: `2037-01-02 01:00:00`

Exemplo de Retorno - text/plain

OK

Exemplos

import requests
 
url = "http://192.168.1.201/cgi-bin/AccessUser.cgi?action=insertMulti"
 
json_data = {
    "UserList": [
        {
            "UserID": "5",
            "UserName": "test",
            "UserType": 0,
            "Authority": 1,
            "Password": "234",
            "Doors": [0,1,2],
            "TimeSections": [255,255,255],
            "ValidFrom": "2019-01-02 00:00:00",
            "ValidTo": "2037-01-02 01:00:00"
        },
        {
            "UserID": "6",
            "UserName": "test",
            "UserType": 0,
            "Password": "234",
            "Doors": [0,3],
            "TimeSections": [255,255],
            "SpecialDaysSchedule": [255],
            "ValidFrom": "2019-01-02 00:00:00",
            "ValidTo": "2037-01-02 01:00:00"
        },
        {
            "UserID": "7",
            "UserName": "test",
            "UserType": 0,
            "UserStatus": 0,
            "Password": "234",
            "Doors": [0],
            "TimeSections": [255],
            "ValidFrom": "2019-01-02 00:00:00",
            "ValidTo": "2037-01-02 01:00:00"
        },
        {
            "UserID": "8",
            "UserName": "test",
            "UserType": 0,
            "UserStatus": 0,
            "Password": "234",
            "Doors": [3],
            "TimeSections": [255],
            "ValidFrom": "2019-01-02 00:00:00",
            "ValidTo": "2037-01-02 01:00:00"
        }
    ]
}
username = "admin"
password = "admin123"
 
def send_user(url, json_data, username, password):
    # Realiza a requisição HTTP POST com autenticação digest
    response = requests.post(url, auth=requests.auth.HTTPDigestAuth(username, password), json=json_data)
    # Retorna o status code e o conteúdo da resposta
    return response.status_code, response.content
 
status_code, response_content = send_user(url, json_data, username, password)
 
print("Status Code:", status_code)
print("Response Content:", response_content)

Definir Antipassback Obter Todos os Usuários