token.create

Descripción

object token.create(object/array tokens)

Este método le permite crear nuevos tokens.

Se requiere el permiso Manage API tokens para que el rol de usuario pueda administrar tokens de otros usuarios.

Un token creado por este método también debe ser generado antes de poder usarse.

Parámetros

(objeto/array) Tokens a crear.

El método acepta tokens con las propiedades estándar del token.

Valores de retorno

(object) Devuelve un objeto que contiene los IDs de los tokens creados bajo la propiedad tokenids. El orden de los IDs devueltos coincide con el orden de los tokens enviados.

Ejemplos

Crear un token

Cree un token habilitado que nunca expire y autentique al usuario con ID 2.

Solicitud:

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

Respuesta:

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

Cree un token deshabilitado que expire el 21 de enero de 2021. Este token autenticará al usuario actual.

Solicitud:

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

Respuesta:

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

Fuente

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