user.create

Descrição

object user.create(object/array users)

Este método permite criar novos usuários.

Este método está disponível apenas para o tipo de usuário Super admin. As permissões para chamar o método podem ser revogadas nas configurações de função de usuário. Veja Funções de usuário para mais informações.

A força da senha do usuário é validada de acordo com as regras de política de senha definidas pela API de Autenticação. Veja API de Autenticação para mais informações.

Parâmetros

(object/array) Usuários a serem criados.

Além das propriedades padrão do usuário, o método aceita os seguintes parâmetros.

Parâmetro Tipo Descrição
usrgrps array Grupos de usuários aos quais adicionar o usuário.

Os grupos de usuários devem ter apenas a propriedade usrgrpid definida.
medias array Mídias do usuário a serem criadas.

Valores de retorno

(object) Retorna um objeto contendo os IDs dos usuários criados na propriedade userids. A ordem dos IDs retornados corresponde à ordem dos usuários passados.

Exemplos

Criando um usuário

Crie um novo usuário, adicione-o a um grupo de usuários e crie uma nova mídia para ele.

Requisição:

{
    "jsonrpc": "2.0",
    "method": "user.create",
    "params": {
        "username": "John",
        "passwd": "Doe123",
        "roleid": "5",
        "usrgrps": [
            {
                "usrgrpid": "7"
            }
        ],
        "medias": [
            {
                "mediatypeid": "1",
                "sendto": [
                    "[email protected]"
                ],
                "active": 0,
                "severity": 63,
                "period": "1-7,00:00-24:00"
            }
        ]
    },
    "id": 1
}

Resposta:

{
    "jsonrpc": "2.0",
    "result": {
        "userids": [
            "12"
        ]
    },
    "id": 1
}

Veja também

Fonte

CUser::create() em ui/include/classes/api/services/CUser.php.