获取联系人详情

批量查询好友或群聊的详细信息。适合在业务系统中补全昵称、头像、备注、标签和加好友凭证。

接口地址： POST /getContact

前置条件

• 微信实例已登录，并已获得可用的 wId。
• 已知道目标好友 wcId 或群聊 ID。
• 批量查询时，单次最多传 20 个目标。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
wcId	是	string	好友微信 ID 或群 ID；多个用英文逗号分隔，单次最多 20 个

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	array	联系人信息列表
data[].userName	string	微信原始 ID
data[].nickName	string	昵称
data[].remark	string	备注名
data[].aliasName	string	微信号，用户设置后返回
data[].signature	string	个性签名
data[].sex	int	性别：1 男、2 女、0 未知
data[].country	string	国家编码
data[].bigHead	string	大头像 URL
data[].smallHead	string	小头像 URL
data[].labelList	string	标签 ID 列表
data[].v1	string	加好友凭证，可搭配添加好友接口使用

请求示例

{
  "wId": "349be9b5-8734-45ce-811d-4e10ca568c67",
  "wcId": "LoChaX,wxid_wl9qchkanp9u22"
}

成功响应

{
  "code": "1000",
  "message": "成功",
  "data": [
    {
      "userName": "test558666",
      "nickName": "追风少年666",
      "remark": "",
      "signature": "66666",
      "sex": 1,
      "aliasName": "test558666",
      "country": "CN",
      "bigHead": "https://wx.qlogo.cn/mmhead/AbCdEfGhIjKlMnOpQrStUv/0",
      "smallHead": "https://wx.qlogo.cn/mmhead/AbCdEfGhIjKlMnOpQrStUv/132",
      "labelList": "",
      "v1": "v1_584e7774024c79af..."
    }
  ]
}

错误响应

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

使用建议

• 批量查询时，每次调用间隔建议 300ms-800ms，避免请求过于频繁。
• 业务系统应优先保存 userName、aliasName、v1 等稳定字段，不要只用昵称匹配联系人。