获取个人主页

获取当前登录实例关联的视频号主页信息，包括当前视频号身份、可切换账号列表和已发布内容摘要。

接口地址： POST /finderHome

前置条件

• 当前 wId 已完成登录，并且账号状态正常。
• 当前微信账号已开通或绑定视频号；如果未开通，返回内容可能为空或失败。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识

请求示例

{
  "wId": "{{wId}}"
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object	当前账号的视频号主页信息
data.userName	string	当前视频号用户编码
data.aliasInfo	array	可用视频号身份列表
data.aliasInfo[].nickName	string	视频号昵称
data.aliasInfo[].headImgUrl	string	视频号头像
data.aliasInfo[].roleType	int	视频号角色类型
data.currentAliasRoleType	int	当前选中的角色类型
data.finderList	array	已发布内容或主页相关卡片数据
data.showInWxFinderUsername	string	微信内展示的视频号用户编码

成功响应

{
  "code": "1000",
  "message": "处理成功",
  "data": {
    "userName": "v2_060000231003b20faec03ec3db0776955d3d97c6b329d6aa58693bcdb7ad1@finder",
    "aliasInfo": [
      {
        "nickName": "朝夕",
        "headImgUrl": "http://wx.qlogo.cn/mmhead/Q3auHgzwzM5grqOsJtnHiaiapZ4cv43GNBzh1sA8NGkwbrvI7Kg3vTcQ/0",
        "roleType": 1
      },
      {
        "nickName": "朝夕v",
        "headImgUrl": "http://wx.qlogo.cn/finderhead/Q3auHgzwzM5grqOsJtnHiaiapZ4cv43GNBJkH0guXYeulzge7e7IQwHg/0",
        "roleType": 3
      }
    ],
    "currentAliasRoleType": 3,
    "finderList": [
      "CgASqwIKVnYyXzA2MDAwMDIzMTAwM2IyMGZhZWM4YzZlMThmMTBjN2Q2YzkwM2VjM2RiMDc3Njk1NWQzZDk3YzZiMzI5ZDZhYTU4NjkzYmNkYjdhZDFAZmluZGVy..."
    ],
    "showInWxFinderUsername": "v2_060000231003b20ffc2d3cd06eb30b077c5587b79cb56b03f12a32fcc8b77f9e7@finder"
  }
}

错误响应

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

使用建议

• 需要获取自己的 myUserName、myRoleType 时，优先调用本接口。
• finderList 可能包含较长的卡片数据，业务侧通常按原样保存或传递，不建议自行拆解。
• 如果账号绑定了多个视频号身份，后续接口应明确使用对应身份的 userName 和 roleType。