获取标签列表

获取当前微信实例下的联系人标签列表。

接口地址： POST /getContactLabelList

前置条件

• 微信实例已登录，并已获得可用的 wId。
• 标签列表属于当前微信实例，不同微信实例之间不共享。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识

请求示例

{
  "wId": "349be9b5-8734-45ce-811d-4e10ca568c67"
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	array/null	标签列表，失败时通常为空
data[].labelId	int	标签 ID
data[].labelName	string	标签名称

成功响应

{
 "message": "成功",
 "code": "1000",
 "data": [
 {
 "labelName": "看一看世界",
 "labelId": 3
 }
 ]
}

错误响应

{
 "message": "失败",
 "code": "1001",
 "data": null
}

使用建议

• 建议业务系统定期同步标签列表，保存 labelId 与业务含义的映射。
• 展示给运营人员时建议同时展示标签名称和标签 ID，避免重名标签造成误操作。
• 删除或修改标签前，建议先刷新一次标签列表，确保操作的是最新标签。