新建分组

接口概述

• 功能：新建分组
• 请求方式：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	无权限