token.create

描述

object token.create(object/array tokens)

此方法允许创建新的令牌。

用户角色需具备管理API令牌配置权限,才能为其他用户管理令牌。

通过此方法创建的令牌还需generated方可使用。

参数

(object/array) 待创建的令牌

该方法接受具有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 文件中。