token.create

描述

object token.create(object/array tokens)

此方法允许create新令牌.

用户角色需要管理API令牌 配置权限才能为其他用户管理令牌.

通过此方法创建的令牌还需generated后才能使用.

参数

(object/array) 令牌用于create功能。

该方法接受具有standard token properties特性的令牌。

返回值

(object) 返回一个包含所创建令牌ID的object，这些ID存储在tokenids属性下。返回的ID顺序与传入的令牌顺序一致。

示例

创建令牌

创建一个永不过期且用于认证ID为2用户的已启用令牌。

请求:

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

响应:

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

创建一个将于2021年1月21日过期的禁用令牌。该令牌将用于认证当前用户。

请求:

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

响应:

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

来源

CToken::create() 位于 ui/include/classes/api/services/CToken.php 文件中。