新建分组

接口概述

• 功能：新建分组
• 请求方式：POST
• 请求地址：/api/contact/groups

请求参数

参数名	类型	必须	参数位置	描述	示例值
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": "InvalidArgument",    "error": {        "type": "invalid_argument"    },    "data": {},    "request_id": "ddec96d2-165e-4f3e-8a64-2057db116983"}

错误码

error.type 错误代码	错误描述
invalid_argument	参数校验不通过
claim_error	无权限