批量创建分组
接口概述
- 功能：批量新建分组
- 请求方式： 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 | 无权限 |