# 新增好友标签


```
POST https://qw-openapi-tx.dustess.com/open-integration-api/tag/v1/qwTag/add?accessToken=

Content-Type: application/json
```

**接口限制**：每分钟调用600次；

**请求参数**

| 请求参数名 | 类型       | 说明                                                                                     | 是否必须 |
| ---------- | ---------- | ---------------------------------------------------------------------------------------- | -------- |
| groupId    | `String`   | 好友标签组id（如果不传，则系统将根据groupName新增分组码，与groupName不能同时为空）       | false    |
| groupName  | `String`   | 好友标签组名称（最长为30个字符, 存在groupID的情况不用此字段无效，与groupId不能同时为空） | false    |
| order      | `Int`      | 标签组次序值。order值大的排序靠前，不传默认为0。有效的值范围是[0, 2^32)                  | false    |
| tag        | `Object[]` | 好友标签列表（单次最多100个）                                                            | true     |
| tag.name   | `String`   | 好友标签名称（最长为30个字符）                                                           | true     |
| tag.order  | `Int`      | 标签组次序值。order值大的排序靠前，不传默认为0。有效的值范围是[0, 2^32)                  | false    |

**请求参数示例**
`json` - Request-Example1:

```json
{
    "groupId": "etMXXWDQAAuAHdAub4i-OZwmimhLjXvg",
    "groupName": "",
    "order": 2,
    "tag": [
        {
            "name": "测试标签名称",
            "order": 1
        }
    ]
}

```

**成功响应**

| 响应参数名                     | 类型       | 说明                       |
| ------------------------------ | ---------- | -------------------------- |
| code                           | `Int`      | 响应码 0:成功              |
| msg                            | `String`   | 消息提示                   |
| success                        | `Bool`     | 请求成功与否               |
| data                           | `Object`   | 企微操作结果数据           |
| data.errcode                   | `Int`      | 企微操作结果错误码  0:成功 |
| data.errmsg                    | `String`   | 企微操作结果错误信息       |
| data.tag_group                 | `Object`   | 标签组信息                 |
| data.tag_group.create_time     | `Int`      | 标签组创建时间             |
| data.tag_group.deleted         | `Bool`     | 标签组是否删除             |
| data.tag_group.group_id        | `String`   | 标签组id                   |
| data.tag_group.group_name      | `String`   | 标签组名称                 |
| data.tag_group.order           | `Int`      | 标签组排序值               |
| data.tag_group.type            | `String`   | 标签类型                   |
| data.tag_group.tag             | `Object[]` | 好友标签列表信息           |
| data.tag_group.tag.create_time | `Int`      | 好友标签创建时间           |
| data.tag_group.tag.deleted     | `Bool`     | 好友标签是否删除           |
| data.tag_group.tag.id          | `String`   | 好友标签Id                 |
| data.tag_group.tag.name        | `String`   | 好友标签名称               |
| data.tag_group.tag.order       | `Int`      | 好友标签排序值             |
| traceId                        | `String`   | 跟踪id                     |

**成功响应示例**

```json
{
    "success": true,
    "code": 0,
    "msg": "ok",
    "data": {
        "errcode": 0,
        "errmsg": "ok",
        "tag_group": {
            "create_time": 1684836846,
            "deleted": false,
            "group_id": "etMXXWDQAAuAHdAub4i-OZwmimhLjXvg",
            "group_name": "openAPI专用",
            "order": 0,
            "type": "",
            "tag": [{
                "create_time": 1684840186,
                "deleted": false,
                "id": "etMXXWDQAAdc09chQFrN3s5gy5OnJj3g",
                "name": "3号",
                "order": 2
            }]
        }
    },
    "trace_id": "c5b491a6-6d76-40c8-b3ad-352fea509867"
}
```

**错误响应示例**

```json
 {
    "success": false,
    "code": 10001,
    "msg": "system unknown error",
    "data": null
}
```