企业管理员创建个人访问令牌

通过 OpenAPI 企业管理员创建个人访问令牌。

适用版本

企业专属版

服务接入点

获取服务接入点,替换 API 请求语法中的 {domain}

授权信息

产品

资源

所需权限

组织管理

用户

读写

请求语法

POST https://{domain}/oapi/v1/platform/users/admin/personalAccessTokens

请求说明

企业管理员创建个人访问令牌

curl -X 'POST' \
  'https://test-domain-***.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": "2025-53-22T12:44:50.048Z",
        "name": "示例令牌名称",
        "permissions": ["base_user_read"],
        "userId": "3001****-****-4229-a7f2-********41ad"
    }'

请求头(Headers)

x-yunxiao-token string (必选)

个人访问令牌。您可参考个人访问令牌获取。

示例:pt-0fh3****0fbG_35af****0484。

请求参数

expiredAt string (必选)

令牌过期时间。

name string (必选)

令牌名称。

permissions array[string] (必选)

令牌权限点。您可以通过企业专属版API获取。

userId string (必选)

用户 id,您可通过ListUsers - 查询用户列表API获取。

descriptionstring (可选)

令牌描述。

返回参数

返回示例

{
    "createdAt": "2025-05-22T12:44:50.048Z",
    "description": "示例令牌描述",
    "expiredAt": "2025-05-22T12:44:50.048Z",
    "name": "示例令牌名称",
    "permissions": ["base_user_read"],
    "token": "pt-0fh3****0fbG_35af****0484",
    "tokenId": "pt-0fh3****0fbG",
    "userId": "3001****-****-4229-a7f2-********41ad"
}

createdAt string

令牌创建时间。

description string

令牌描述。

expiredAt string

令牌过期时间。

name string

令牌名称。

permissions array[string]

令牌权限点。

token string

个人访问令牌。

tokenId string

令牌 id。

userId string

用户 id。

错误码

访问错误码中心查看 API 相关错误码。