关注

关注或取消关注指定视频号用户。

接口地址： POST /finderFollow

前置条件

• 当前 wId 已完成登录，并且账号状态正常。
• userName 为目标视频号用户编码，通常来自搜索接口或主页接口。
• meUserName、meRoleType 建议从个人主页接口返回值中读取。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
userName	是	string	目标视频号用户编码
meUserName	是	string	自己的视频号用户编码
meRoleType	是	int	自己的视频号角色类型
type	是	int	操作类型：1 关注，2 取消关注

请求示例

{
  "wId": "{{wId}}",
  "meUserName": "v2_060000231003b20faec8cae18a1ec5d0cb07eab077ba915250774edbea38082ea6b24af229@finder",
  "userName": "v2_060000231003b20faec8c6e78010c3d4c605eb3cb077f16e37c172145877400390b1170a0299@finder",
  "meRoleType": 3,
  "type": 1
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object	目标视频号用户信息
data.userName	string	目标视频号用户编码
data.nickName	string	昵称
data.headUrl	string	头像地址
data.signature	string	个性签名
data.authInfo	object	认证信息
data.extInfo	object	扩展资料
data.userMode	int	用户模式，可能为 null
data.bindInfo	string	绑定信息，按原样保存

成功响应

{
  "code": "1000",
  "message": "处理成功",
  "data": {
    "userName": "v2_060000231003b20faec8c6e78010c3d4c605eb3cb077f16e37c172145877400390b1170a0299@finder",
    "nickName": "中国日报",
    "headUrl": "https://wx.qlogo.cn/finderhead/ver_1/example/0",
    "signature": "",
    "authInfo": {
      "authIconType": 2,
      "authProfession": "中国日报社",
      "detailLink": "pages/index/index.html?showdetail=true&username=v2_060000231003b20faec8c6e78010c3d4c605eb3cb077f16e37c172145877400390b1170a0299@finder",
      "appName": "gh_4ee148a6ecaa@app"
    },
    "extInfo": {
      "country": "CN",
      "province": "",
      "city": "",
      "sex": null
    },
    "userMode": null,
    "bindInfo": "CAESwwIKwAIKD2doXzM3MDdkOTU0MWMzZhIM..."
  }
}

错误响应

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

使用建议

• 取消关注时仅需将 type 改为 2，其余身份字段保持一致。
• bindInfo 通常不需要解析，业务侧按原样保存即可。
• 如果关注失败，优先检查目标 userName 是否有效，以及当前账号是否存在操作限制。