Appearance
获取某标签下联系人
当前版本未提供此接口
当前版本未提供此接口,调用不会生效,API Playground 中也不可执行。需要查询某标签下联系人时,建议使用替代方案:
- 调用获取联系人接口,同步联系人基础列表。
- 调用批量获取好友信息接口,获取好友详情。
- 读取好友信息中的
labelList字段并存入业务库。 - 在业务库中按标签 ID 查询联系人。
接口地址: POST /getLabelContacts
前置条件
- 本接口已关闭,不建议新业务继续接入。
- 如历史系统仍保留调用,请尽快迁移到基于
labelList的本地查询方案。
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| wId | 是 | string | 登录实例标识 |
| labelId | 是 | int | 标签 ID |
请求示例
json
{
"wId": "349be9b5-8734-45ce-811d-4e10ca568c67",
"labelId": 1
}响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | string | 1000 成功,1001 失败 |
| message | string | 反馈信息 |
| data | array/null | 历史返回字段;接口关闭后不建议依赖 |
成功响应
json
{
"message": "成功",
"code": "1000",
"data": []
}错误响应
json
{
"message": "失败",
"code": "1001",
"data": null
}使用建议
- 新接入不要依赖本接口,应以好友详情中的
labelList字段作为标签关系来源。 - 建议在业务库中维护
wcId -> labelIdList的映射,查询标签联系人时直接走本地索引。 - 迁移历史调用时,先对比一批联系人标签关系,确认本地数据与微信侧一致后再下线旧调用。