POST/api/v1/admin/users/:userId/roles授予管理角色

Try it 面板需要启用 JavaScript。

向用户授予一个管理角色（admin 范围）。

Request

Headers

Name	Data Type	Required	Description
Authorization	string	Yes	会话令牌认证，格式 `Bearer <sessionToken>`
Content-Type	string	Yes	请求体内容类型（默认值 "application/json"）

type RequestHeaders = {
  /** 会话令牌认证，格式 `Bearer <sessionToken>` */
  Authorization: string
  /** 请求体内容类型，默认值 "application/json" */
  Content-Type: string
}

{
  "Authorization": "Bearer st_7c1f9e05b28d4a63",
  "Content-Type": "application/json"
}

URL Parameters

Name	Data Type	Description
userId	string	用户 ID

Body

Name	Data Type	Required	Description
roleId	string	Yes	管理角色 ID

type RequestBody = {
  /** 管理角色 ID */
  roleId: string
}

{
  "roleId": "01JD8STA3N7V0X8ZS7X1ZFN4A9Q"
}

Response

Body

result type: null

HTTP Code

HTTP Status	Meaning	Notes
200	成功	角色已授予

Response Code

响应使用统一信封 {id, code, messages, result}，其 code 字段：

code	Meaning	Notes
0	成功	角色已授予
2605	已持有该角色	该用户已持有此角色

Examples

POST /api/v1/admin/users/01JD8SEGQ0P9N2XK4L7VDH3T6C/roles
Authorization: Bearer st_7c1f9e05b28d4a63
Content-Type: application/json

{
  "roleId": "01JD8STA3N7V0X8ZS7X1ZFN4A9Q"
}

{
  "id": "01JD8ST6WB1W4XN",
  "code": 0,
  "messages": [],
  "result": null
}