# 添加企业客户标签
请求方式: POST
请求地址: https://nbd-api.myscrm.cn/bff-nbd-qw-openapi/v1/corp-tag/add
请求参数说明:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
app_id | string | 是 | 企微中台应用 id |
group_id | string | 否 | 签组 id |
group_name | string | 否 | 标签组名称,最长为 30 个字符 |
order | int64 | 否 | 标签组次序值。order 值大的排序靠前。有效的值范围是[0, 2^32) |
tag.name | string | 是 | 添加的标签名称,最长为 30 个字符 |
tag.order | int64 | 否 | 标签次序值。order 值大的排序靠前。有效的值范围是[0, 2^32) |
请求参数示例:
{
"app_id": "xxxxx",
"group_id": "GROUP_ID",
"group_name": "GROUP_NAME",
"order": 1,
"tag": [
{
"name": "TAG_NAME_1",
"order": 1
},
{
"name": "TAG_NAME_2",
"order": 2
}
]
}
返回数据:
{
"errcode": 0,
"errmsg": "ok",
"tag_group": {
"group_id": "TAG_GROUPID1",
"group_name": "GOURP_NAME",
"create_time": 1557838797,
"order": 1,
"tag": [
{
"id": "TAG_ID1",
"name": "NAME1",
"create_time": 1557838797,
"order": 1,
"deleted": false
},
{
"id": "TAG_ID2",
"name": "NAME2",
"create_time": 1557838797,
"order": 2,
"deleted": false
}
]
}
}
返回参数说明:
名称 | 类型 | 说明 |
---|---|---|
tag_group.group_id | string | 标签组 id |
tag_group.group_name | string | 标签组名称 |
tag_group.create_time | int64 | 标签组创建时间 |
tag_group.order | int64 | 标签组排序的次序值,order 值大的排序靠前。有效的值范围是[0, 2^32) |
tag_group.deleted | bool | 标签组是否已经被删除,只在指定 tag_id 进行查询时返回 |
tag_group.tag.id | string | 标签 id |
tag_group.tag.name | string | 标签名称 |
tag_group.tag.create_time | int64 | 标签创建时间 |
tag_group.tag.order | int64 | 标签排序的次序值,order 值大的排序靠前。有效的值范围是[0, 2^32) |
tag_group.tag.deleted | bool | 标签是否已经被删除 |