CreateUserPersonalAccessToken - 企业管理员创建个人访问令牌
企业管理员为指定用户创建个人访问令牌。
服务接入点与授权信息
请求语法
POST https://{domain}/oapi/v1/platform/users/admin/personalAccessTokens
请求头
参数 |
类型 |
是否必填 |
描述 |
示例值 |
x-yunxiao-token |
string |
是 |
个人访问令牌。 |
pt-0fh3****0fbG_35af****0484 |
请求参数
参数 |
类型 |
位置 |
是否必填 |
描述 |
示例值 |
- |
object |
body |
否 |
|
|
description |
string |
body |
否 |
令牌描述。 |
示例令牌描述 |
expiredAt |
string |
body |
是 |
令牌过期时间。 |
2023-03-22T12:44:50.048Z |
name |
string |
body |
是 |
令牌名称。 |
示例令牌名称 |
permissions |
array[string] |
body |
是 |
令牌权限点。 |
["base_user_read"] |
rate |
integer |
body |
否 |
每分钟最大访问次数。 |
20 |
请求示例
curl -X 'POST' \
'https://test.rdc.aliyuncs.com/oapi/v1/platform/users/admin/personalAccessTokens' \
-H 'Content-Type: application/json' \
-H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484' \
--data '
{
"description": "示例令牌描述",
"expiredAt": "2023-03-22T12:44:50.048Z",
"name": "示例令牌名称",
"permissions": ["base_user_read"],
"userId": "3001****-****-4229-a7f2-********41ad",
"rate": 20
}'
返回参数
参数 |
类型 |
描述 |
示例值 |
- |
object |
|
|
createdAt |
string |
令牌创建时间。 |
2023-03-22T12:44:50.048Z |
description |
string |
令牌描述。 |
示例令牌描述 |
expiredAt |
string |
令牌过期时间。 |
2023-03-22T12:44:50.048Z |
name |
string |
令牌名称。 |
示例令牌名称 |
permissions |
array[string] |
令牌权限点。 |
["base_user_read"] |
token |
string |
个人访问令牌。 |
pt-0fh30fbG_35af0484 |
tokenId |
string |
令牌 id。 |
pt-0fh3**0fbG |
userId |
string |
用户 id。 |
3001--4229-a7f2-**41ad |
rate |
integer |
每分钟最大访问次数。 |
20 |
返回示例
{
"createdAt": "2023-03-22T12:44:50.048Z",
"description": "示例令牌描述",
"expiredAt": "2023-03-22T12:44:50.048Z",
"name": "示例令牌名称",
"permissions": ["base_user_read"],
"token": "pt-0fh3****0fbG_35af****0484",
"tokenId": "pt-0fh3****0fbG",
"userId": "3001****-****-4229-a7f2-********41ad",
"rate": 20
}
错误码
访问错误码中心查看 API 相关错误码。