添加/更新授权信息
添加新的授权信息或更新现有授权信息。
请求方式
POST /api/v1/grant/admin
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | int | 否 | 授权ID(更新时必填) |
| name | string | 是 | 授权名称 |
| description | string | 否 | 授权描述 |
| group_id | int | 是 | 所属分组ID |
| state | boolean | 否 | 授权状态(默认true) |
| fields | array | 否 | 授权字段列表 |
字段数据结构
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | 字段名称 |
| type | string | 是 | 字段类型 |
| required | boolean | 是 | 是否必填 |
| description | string | 否 | 字段描述 |
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码(200-成功) |
| msg | string | 操作结果消息 |
| grant_id | int | 授权ID |
请求示例
{
"name": "订单管理权限",
"description": "允许管理订单数据",
"group_id": 123,
"fields": [
{
"name": "order_id",
"type": "string",
"required": true,
"description": "订单ID"
}
]
}
响应示例
{
"code": 200,
"msg": "操作成功",
"grant_id": 789
}
错误码
| 错误码 | 说明 |
|---|---|
| 400 | 参数错误 |
| 403 | 无权限操作 |
| 500 | 服务器内部错误 |