添加好友

向搜索到的联系人发送好友申请。

接口地址： POST /addUser

前置条件

• 微信实例已登录，并已获得可用 wId。
• 已通过 搜索联系人 获取 v1 和 v2。
• 新登录微信建议在线 7 天后再调用添加好友接口。
• 添加好友是敏感动作，请按真实业务触发，不要批量高频调用。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
v1	是	string	添加好友凭证，从搜索联系人接口获取
v2	是	string	添加好友凭证，从搜索联系人接口获取
type	是	int	添加来源：3 微信号搜索、4 QQ 好友、8 群聊、15 手机号
verify	是	string	验证消息

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	null	成功时通常为空

请求示例

{
  "wId": "0000016f-a2f0-03e3-0003-65e826091614",
  "v1": "v1_aaf94e13d0058cdc888e388b98952e0fc23212d180e4dacb38b96dfe4b078c488e72772f907517470ac0b9b7311826da@stranger",
  "v2": "v2_13ced007472228cd1545feecf78b99f9a57a88843374513747afc7ac25d8a4cccb77590b7a9b01a96c941e047d137bbb@stranger",
  "type": 3,
  "verify": "你好"
}

成功响应

{
  "code": "1000",
  "message": "成功",
  "data": null
}

错误响应

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

使用建议

• 把添加请求写入队列，控制每日数量和间隔。
• 同一目标不要重复发起好友申请。
• 申请发送成功不等于好友已通过。好友通过后，调用 获取联系人详情（完整版） 获取 v3 确认关系。