# 查询群标签列表



```
POST https://qw-openapi-tx.dustess.com/customer/v1/group/tag/list?accessToken=

Content-Type: application/json
```

**接口限制**:每分钟调用600次;单次请求最多传递100条数据;

**Query:**

| 字段        | 类型     | 描述        | 是否必须 |
| ----------- | -------- | ----------- | -------- |
| accessToken | `String` | accessToken | 是       |

**请求参数:**

| 字段          | 类型     | 描述                         | 是否必须 |
| ------------- | -------- | ---------------------------- | -------- |
| tagId        | `string` | 群聊标签id                     | 否       |



请求参数示例:

```json
{
    "tagId": "911e97c1-252b-11ed-9184-b2d4f028e399"
}
```

**成功响应:**

| 名称                  | 类型       | 默认值 | 备注     |     
| --------------------- | ---------- | ------ | -------- | 
| code                  | `Int`      |        | 响应码   |     |
| msg                   | `string`   |        | 消息提示 |     |
| success               | `Bool`     |        | 是否成功 |     |
| data                  | `object[]` |        | 返回数据 |     |
| data.backgroundColor | `string`   |        | 背景色   |     |
| data.createTime       | `string`   |        | 创建时间 |     |
| data.enable           | `boolean`  |        | 是否启用 |     |
| data.groupId               | `string`   |        | 标签组ID   |     |
| data.name              | `string`   |        | 标签名   |     |
| data.order            | `int`      |        | 排序     |     |
| data.singleChoice    | `boolean`  |        | 是否单选 |     |
| data.textColor       | `string`   |        | 字体颜色 |     |
| data.updateTime       | `string`   |        | 更新时间 |     |
| data.children       | `object[]`   |        | 子标签 |     |
| data.children.backgroundColor | `string`   |        | 背景色   |     |
| data.children.createTime       | `string`   |        | 创建时间 |     |
| data.children.enable           | `boolean`  |        | 是否启用 |     |
| data.children.tagId               | `string`   |        | 标签ID   |     |
| data.children.name              | `string`   |        | 标签名   |     |
| data.children.order            | `int`      |        | 排序     |     |
| data.children.parentId         | `string`   |        | 父级ID   |     |
| data.children.singleChoice    | `boolean`  |        | 是否单选 |     |
| data.children.textColor       | `string`   |        | 字体颜色 |     |
| data.children.updateTime       | `string`   |        | 更新时间 |     |
| traceId               | `string`   |        |          |     |

成功响应示例:

```json
{
	"success": true,
	"code": 0,
	"msg": "ok",
	"data": [
		{
			"groupId": "abc465fb-9fb8-11ed-a53a-c6e28f6af652",
			"name": "群标签",
			"enable": true,
			"order": 1,
			"createTime": "2023-01-29 17:38:22",
			"updateTime": "2023-01-29 17:38:22",
			"backgroundColor": "rgba(252,247,233,1)",
			"textColor": "rgba(251,187,61,1)",
			"singleChoice": false,
			"children": [
				{
					"tagId": "ee2cd992-f718-478e-b468-e4ab491a9e52",
					"parentId": "abc465fb-9fb8-11ed-a53a-c6e28f6af652",
					"name": "群标签1",
					"enable": true,
					"order": 8,
					"createTime": "2023-06-07 17:31:43",
					"updateTime": "2023-06-07 17:31:43",
					"backgroundColor": "rgba(252,247,233,1)",
					"textColor": "rgba(251,187,61,1)",
					"singleChoice": false,
					"children": null
				}
		]
		}
	],
	"traceId": "7c1e3bb7-3d3c-98f8-b5d8-2cc7c20c8402"
}
```