DELETE/api/v1/admin/users/:userId/roles/:roleId撤销管理角色
Try it 面板需要启用 JavaScript。
移除用户持有的一个管理角色。
Request
Headers
| Name | Data Type | Required | Description |
|---|---|---|---|
| Authorization | string | Yes | 会话令牌认证,格式 `Bearer <sessionToken>` |
type RequestHeaders = {
/** 会话令牌认证,格式 `Bearer <sessionToken>` */
Authorization: string
}URL Parameters
| Name | Data Type | Description |
|---|---|---|
| userId | string | 用户 ID |
| roleId | string | 管理角色 ID |
Response
Body
result type: null
HTTP Code
| HTTP Status | Meaning | Notes |
|---|---|---|
| 200 | 成功 | 角色已撤销 |
| 404 | 未持有该角色 | 该用户不持有此角色 |
Response Code
响应使用统一信封 {id, code, messages, result},其 code 字段:
| code | Meaning | Notes |
|---|---|---|
| 0 | 成功 | 角色已撤销 |
| 2603 | 未持有该角色 | 该用户不持有此角色 |
Examples
DELETE /api/v1/admin/users/01JD8SEGQ0P9N2XK4L7VDH3T6C/roles/01JD8STA3N7V0X8ZS7X1ZFN4A9Q
Authorization: Bearer st_7c1f9e05b28d4a63
{
"id": "01JD8ST7XC2X5YO",
"code": 0,
"messages": [],
"result": null
}
Remarks
撤销最后一个管理角色即失去管理域访问权(全部 admin 接口此后返回 1003)。