添加/修改分组成员
团队使用该接口前，需要提前获得用户的 user_id，有两种方法:
方法1： 从通讯录页面邀请成员加入团队后，通过获取成员列表 获得 user_id
方法2： 使用注册用户创建一个第三方账号，获得 user_id
接口概述
- 功能：添加成员
- 请求方式：POST
- 请求地址：/api/contacts/teams/{team_id}/groups/{group_id}/users/{user_id}?appid={appid}&access_token={access_token}
请求参数
| 参数名 | 类型 | 必须 | 参数位置 | 描述 | 示例值 |
|---|---|---|---|---|---|
| team_id | integer | 是 | uri | 团队ID | 43 |
| group_id | integer | 是 | uri | 分组ID | 1923 参数为0时默认添加到“根目录” |
| user_id | integer | 是 | uri | 用户ID | 60000208205 |
| openid | string | 否 | body | 用户在第三方平台的唯一标识仅合作平台可用该字段与 open_id 一致，如果同时指定仅 openid 生效 | abcdefg |
| open_id | string | 否 | body | 用户在第三方平台的唯一标识仅合作平台可用该字段废弃，请使用 openid | abcdefg |
| role | integer | 否 | body | 角色，受团队可用人数限制 | 2:团队管理员;3:问卷管理员;4:普通成员 |
响应参数
无
响应示例
- 请求成功
{
"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_existed | 用户已存在于通讯录 |
| contacts_team_not_found | 团队不存在 |
| contacts_group_not_found | 分组不存在 |
| contacts_user_not_found | 用户不存在 |
| contacts_add_user_error | 添加用户失败 |
| invalid_argument | 参数错误 |
| claim_error | 无权限 |