token.create

Descrição

object token.create(object/array tokens)

Este método permite criar novos tokens.

A permissão Gerenciar tokens de API permission é necessária para a função de usuário gerenciar tokens de outros usuários.

Um token criado por este método também precisa ser gerado antes de ser utilizável.

Parâmetros

(objeto/array) Tokens para criar.

O método aceita tokens com as propriedades de token padrão.

Valores de retorno

(object) Retorna um objeto contendo os IDs dos tokens criados na propriedade tokenids. A ordem dos IDs retornados corresponde à ordem dos tokens passados.

Exemplos

Criar um token

Crie um token habilitado que nunca expira e autentica o usuário de ID 2.

Requisição:

{
    "jsonrpc": "2.0",
    "method": "token.create",
    "params": {
        "name": "Your token",
        "userid": "2"
    },
    "id": 1
}

Resposta:

{
    "jsonrpc": "2.0",
    "result": {
        "tokenids": [
            "188"
        ]
    },
    "id": 1
}

Crie um token desabilitado que expira em 21 de janeiro de 2021. Este token autenticará o usuário atual.

Requisição:

{
    "jsonrpc": "2.0",
    "method": "token.create",
    "params": {
        "name": "Your token",
        "status": "1",
        "expires_at": "1611238072"
    },
    "id": 1
}

Resposta:

{
    "jsonrpc": "2.0",
    "result": {
        "tokenids": [
            "189"
        ]
    },
    "id": 1
}

Fonte

CToken::create() in ui/include/classes/api/services/CToken.php.