批量创建分组
#
接口概述- 功能:批量新建分组
- 请求方式: POST
- 请求地址:/api/contacts/teams/{team_id}/groups/batch
#
请求参数参数名 | 类型 | 必须 | 参数位置 | 描述 | 示例值 |
---|---|---|---|---|---|
groups | array[object] | 是 | body | 要添加的分组列表 | |
groups[_].name | string | 是 | body | 分组名称 | 测试分组 |
groups[_].parent_id | integer | 否 | body | 上级分组ID | 0 |
groups[_].order | integer | 否 | body | 排序 | 1 |
groups[_].remote_id | string | 否 | body | 用户ID | |
team_id | integer | 是 | uri | 团队ID | 30 |
#
响应参数无
#
响应示例- 请求成功
{ "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 错误代码 | 错误描述 |
---|---|
group_create_error | 创建不成功 |
invalid_argument | 参数错误 |
claim_error | 无权限 |