修改分组
#
接口概述- 功能:修改分组
- 请求方式:POST
- 请求地址:/api/contact/groups/{group_id}?appid={appid}&access_token={access_token}
#
请求参数参数名 | 类型 | 必须 | 参数位置 | 描述 | 示例值 |
---|---|---|---|---|---|
name | string | 是 | body | 分组名称 | 我的分组 |
owner_user_id | integer | 是 | body | 分组所属帐号(个人用户ID或团队ID | 60002245150 |
owner_user_type | integer | 是 | body | 分组所属帐号类型 1=团队,2=个人用户 | 1 |
#
响应参数参数名 | 类型 | 描述 |
---|---|---|
group_id | integer | 分组ID |
owner_user_id | integer | 分组所属个人用户ID或团队ID |
creator_user_id | integer | 分组ID |
identity | string | 分组标识(相同owner_user_id下唯一) |
internal_group_id | integer | 该分组存在于团队通讯录中的id(为0表示不存在于团队通讯录) |
name | string | 分组名称 |
created_at | string | 创建时间 |
updated_at | string | 更新时间 |
parent_id | integer | 父级分组ID |
order | integer | 排序(数值越大越靠后) |
#
响应示例- 请求成功
{ "code": "OK", "error": { "type": "" }, "data": { "group": { "id": 3259358, "owner_user_id": 60002245150, "creator_user_id": 50000012518, "identity": "", "internal_group_id": 0, "name": "未命名分组", "is_default": 0, "created_at": "2022-10-16 20:13:52", "updated_at": "2022-10-16 20:13:52", "parent_id": 0, "order": 0 } }, "request_id": "7c61197c-5682-46b8-9a55-eea533ac2739"}
- 请求失败
{ "code": "NotFound", "error": { "type": "contacts_group_not_found" }, "data": {}, "request_id": "e82ce6af-3256-4805-aca6-b86c19d6c334"}
#
错误码error.type 错误代码 | 错误描述 |
---|---|
invalid_argument | 参数校验不通过 |
claim_error | 无权限 |