修改成员
接口概述
- 功能:修改成员
- 请求方式:POST
- 请求地址:/api/contacts/teams/{team_id}/users/{user_id}?appid={appid}&access_token={access_token}
请求参数
| 参数名 | 类型 | 必须 | 参数位置 | 描述 | 示例值 |
|---|---|---|---|---|---|
| team_id | integer | 是 | uri | 团队 ID | 34 |
| user_id | integer | 是 | uri | 用户 ID | 60000208205 |
| group_ids | array[integer] | 否 | body | 分组 ID | [86,87] |
| nickname | string | 否 | body | 通讯录昵称 | 李四 |
| avatar | string | 否 | body | 通讯录头像 | https://wj.gtimg.com/default/default_headimg.png |
| role | integer | 否 | body | 角色,受团队可用人数限制 | 2:团队管理员;3:问卷管理员;4:普通成员 |
| openid | string | 否 | body | 用户在第三方平台的唯一标识仅合作平台可用该字段与 open_id 一致,如果同时指定仅 openid 生效 | abcdefg |
| open_id | string | 否 | body | 用户在第三方平台的唯一标识仅合作平台可用该字段废弃,请使用 openid | abcdefg |
响应参数
无
响应示例
- 请求成功
{
"code": "OK",
"error": {
"type": ""
},
"data": {},
"request_id": "10595b0f-9333-4ad7-8bda-ce2c00119758"
}
- 请求失败
{
"code": "InvalidArgument",
"error": {
"type": "invalid_param"
},
"data": {},
"request_id": "793fb149-4f12-4439-aa83-01d0e211b15c"
}
错误码
| error.type 错误代码 | 错误描述 |
|---|---|
| contacts_user_not_found | 用户不存在 |
| group_edit_error | 修改分组失败 |
| role_edit_error | 修改角色失败 |
| exceed_user_limit | 可用人数超过限制 |
| invalid_argument | 参数错误 |
| claim_error | 无权限 |