token.get

Descripción

integer/array token.get(object parameters)

El método permite recuperar tokens según los parámetros dados.

Sólo el tipo de usuario Super administrador puede ver tokens para otros usuarios.

Parámetros

(objeto) Parámetros que definen la salida deseada.

El método admite los siguientes parámetros.

Parámetro Tipo Descripción
tokenids ID/array Devolver solo los tokens con los IDs indicados.
userids ID/array Devolver solo los tokens creados para los usuarios indicados.
token string Devolver solo los tokens creados para el Token de autenticación indicado.
valid_at timestamp Devolver solo los tokens que sean válidos (no expirados) en la fecha y hora indicadas.
expired_at timestamp Devolver solo los tokens que estén expirados (no válidos) en la fecha y hora indicadas.
sortfield string/array Ordenar el resultado por las propiedades indicadas.

Valores posibles: tokenid, name, lastaccess, status, expires_at, created_at.
countOutput boolean Estos parámetros se describen en el comentario de referencia.
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Valores de retorno

(entero/matriz) Devuelve:

  • una matriz de objetos;
  • el recuento de objetos recuperados, si el parámetro countOutput ha sido usado.

Ejemplos

Recuperar un token

Recupere todos los datos del token con ID "2".

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "token.get",
    "params": {
        "output": "extend",
        "tokenids": "2"
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "tokenid": "1",
            "name": "The Token",
            "description": "",
            "userid": "1",
            "lastaccess": "0",
            "status": "0",
            "expires_at": "1609406220",
            "created_at": "1611239454",
            "creator_userid": "1"
        }
    ],
    "id": 1
}

Fuente

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