修改用户动态值属性接口
更新时间: 2022-12-05 15:43:24
接口说明
修改用户动态值属性的值。
基本信息:
属性 | 值 |
---|---|
API | /api/dash/userAttr/update |
Method | POST |
请求参数:
字段名称 | 参数类型 | 参数说明 |
---|---|---|
token | String | 鉴权token,该用户必须是系统里的域管理员 |
uniqueId | String | uniqueId |
userId | Int | 用户ID |
attrs | Array | 用户权限属性值 |
uniqueId
和userId
二选一,优先匹配uniqueId
,若都不填会报错
用户权限属性值 attrs
参数说明:
字段名称 | 参数类型 | 参数说明 |
---|---|---|
attrId | Int | 属性id |
attrName | String | 属性名称。(与attrId任选其一即可) |
attrValue | Array(或null ) |
属性值 |
属性id (attrId):如果用户只有 attrId 为1、3、5的属性,那么只需要在接口中设置这几个属性的值即可,没有被设置的属性可以理解为 attrValue 为null
,可以传也可以不传。如果用户已有该attrId的属性值,则会被新值覆盖。
属性名称 (attrName):属性列表中的属性名。设置方法同上。
属性值 (attrValue):正常情况下是一个字符串数组。
如果要清除用户的对应 attrId 的属性,attrValue 应设置为 null
,这表示该用户没有被这个属性限制权限。如果 attrValue 的值为 []
,说明用户完全没有该属性所关联的列的查看权限。
注意:调用 用户批量导入接口 设置用户属性与调用本接口设置用户属性效果是一样的,这两个接口的接口参数中的attrs
的处理方式是相同的。所以,如果只想导入用户属性,也可以调用本接口(/api/dash/userAttr/update
)。
{
"userId":141,// 或 "uniqueId": "abc@163.com"
"attrs" : [
{
"attrId":1,
"attrValue":["武汉大学","黄冈师范学院"]
},
{
"attrId":3,
"attrValue":[]
},
{
"attrId":5,
"attrValue":null
}
]
}
成功数据返回
{
"code": 200,
"result": "ok",
}