登录视频号助手

通过视频号助手二维码确认登录，获取视频号助手会话和可管理的视频号列表。

接口地址： POST /scanFinderHelper

前置条件

• 当前 wId 已完成登录，并且账号状态正常。
• 先打开视频号助手登录页，获取二维码解析后的确认登录地址。
• url 应传二维码解析后的 confirm_login 地址，不是普通页面地址。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
url	是	string	视频号助手二维码解析后的确认登录地址

请求示例

{
  "wId": "{{wId}}",
  "url": "https://channels.weixin.qq.com/mobile/confirm_login.html?token=AQAAADuBfwIdyYlrciNBWQ"
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object	视频号助手登录结果
data.sessionId	string	视频号助手会话 ID
data.acctStatus	int	账号状态
data.finderList	array	当前账号可管理的视频号列表
data.finderList[].finderUsername	string	视频号用户编码
data.finderList[].nickname	string	视频号昵称
data.finderList[].headImgUrl	string	头像地址
data.finderList[].coverImgUrl	string	封面地址
data.finderList[].spamFlag	int	风控标识
data.finderList[].acctType	int	账号类型
data.finderList[].authIconType	int	认证图标类型
data.finderList[].ownerWxUin	number	归属微信 UIN
data.finderList[].adminNickname	string	管理员昵称
data.finderList[].categoryFlag	string	分类标识
data.finderList[].uniqId	string	视频号唯一 ID
data.finderList[].isMasterFinder	boolean	是否主视频号

成功响应

{
  "code": "1000",
  "message": "处理成功",
  "data": {
    "sessionId": "BgAAoFaoS/vANMJKEyZH+Au/nki9zvLCL0es8VRNvfPrAC96a8lTJRzJHPzeUODIw7y/yQPlPGp5C07/D+hsIwjjOSx6q0m",
    "acctStatus": 1,
    "finderList": [
      {
        "finderUsername": "v2_060000231003b20faec8c6e18f10cc903ec3db0776955d3d97c6b329d6aa58693bcdb7ad1@finder",
        "nickname": "vvvv",
        "headImgUrl": "https://wx.qlogo.cn/finderhead/Q3auHgzwqOsJtnHiaiapZ4cv43GNBJkH0guXYeulzge7e7IQwHg/0",
        "coverImgUrl": "",
        "spamFlag": 0,
        "acctType": 1,
        "authIconType": 0,
        "ownerWxUin": 2207814660,
        "adminNickname": "hhh。",
        "categoryFlag": "0",
        "uniqId": "sphZ1RF6CMuZAn",
        "isMasterFinder": true
      }
    ]
  }
}

错误响应

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

使用建议

• 二维码登录地址有时效，过期后需要重新获取并重新提交。
• 登录成功后建议保存 sessionId 和 finderList，用于后续视频号助手相关操作。
• 如果 finderList 为空，先确认该微信号是否具备视频号管理权限。