token.get

Описание

целое число/массив token.get(параметры объекта)

Этот метов позволяет получать токены в соответствии с заданными параметрами.

Только пользователю типа Super admin разрешено видеть токены других пользователей.

Parameters

(object) Parameters defining the desired output.

The method supports the following parameters.

Parameter	Type	Description
tokenids	string/array	Return only tokens with the given IDs.
userids	string/array	Return only tokens created for the given users.
token	string	Return only tokens created for the given Auth token.
valid_at	timestamp	Return only tokens which are valid (not expired) at the given date and time.
expired_at	timestamp	Return only tokens which are expired (not valid) at the given date and time.
sortfield	string/array	Sort the result by the given properties. Possible values are: `tokenid`, `name`, `lastaccess`, `status`, `expires_at` and `created_at`.
countOutput	boolean	These parameters being common for all `get` methods are described in detail in the reference commentary.
excludeSearch	boolean
filter	object
limit	integer
output	query
preservekeys	boolean
search	object
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	string/array
startSearch	boolean

Возвращаемые значения

(целое число/массив) Возвращает либо:

· массив объектов;
· количество извлеченных объектов, если использовался параметр countOutput.

Примеры

Получение токена

Получить все данне для токена с ID "2".

Запрос:

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

Ответ:

{
           "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
       }

Исходный код

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

Documentation