搜索联系人

通过微信号或手机号搜索联系人。通常用于添加好友前获取 v1、v2 等凭证。

接口地址： POST /searchUser

前置条件

• 微信实例已登录，并已获得可用的 wId。
• 已确认搜索目标为微信号或手机号；本接口不支持用微信 ID 搜索。
• 搜索动作属于敏感操作，请按真实业务触发，不建议高频批量调用。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
wcId	是	string	微信号或手机号，不支持微信 ID 搜索

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object	搜索结果
data.nickName	string	昵称
data.sex	int	性别
data.v1	string	添加好友凭证；如果已是好友，可能返回好友微信 ID
data.v2	string	添加好友凭证
data.userName	string	微信号或临时搜索标识
data.bigHead	string	大头像 URL
data.smallHead	string	小头像 URL

请求示例

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

成功响应

{
  "code": "1000",
  "message": "成功",
  "data": {
    "nickName": "可可",
    "sex": 2,
    "v1": "v1_90c13d2bb0ff6bb85db28041af32ec2cc80194eac15c3ab6534d28c127a2270e802c06bba0a41a904423a01855870756@stranger",
    "userName": "v1_90c13d2bb0ff6bb85db28041af32ec2cc80194eac15c3ab6534d28c127a2270e802c06bba0a41a904423a01855870756@stranger",
    "v2": "v4_000b708f0b040000010000000000b1bda847bd5ff86a7d236cdee25e1000000050ded0b020927e3c97896a09d47e6e9e387eb23497cde91ca8c3d17dc5cfb3703eb5c81a9b0c457a9cafb398238b24ad0c0e060c43c6bd464ca15269a601c3dffa3da32a659c32e7e58eeee0b9ec7873c5a4828ce51992d917@stranger",
    "bigHead": "https://wx.qlogo.cn/mmhead/AbCdEfGhIjKlMnOpQrStUv/0",
    "smallHead": "https://wx.qlogo.cn/mmhead/AbCdEfGhIjKlMnOpQrStUv/132"
  }
}

错误响应

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

使用建议

• 搜索好友经常搭配 添加好友 使用。
• 好友同意后会产生回调，业务系统可用搜索返回的 v1 和回调中的 v1、wcId 做关联。
• 已经是好友时，v2 可能为空，应按实际返回结果兼容处理。