微信个人号开发API-VideosApi.com-微信机器人开发
  1. 视频号模块
  • 开发说明
    • 对接须知
    • 对接步骤
    • 消息回调
    • 消息回调接口说明
    • 接入Api相关问答
  • 项目案例(部分)
    • 视频号智能化
    • 客户管理系统/SCRM
    • 群活码
    • 个性业务开发案例
  • 开发API
    • 登录模块
      • (步骤1)获取登录二维码
        POST
      • (步骤2)执行登录
        POST
      • 弹框登录
        POST
      • 退出
        POST
      • 检查是否在线
        POST
      • 异常断线重连
        POST
    • 联系人相关接口
      • 获取通讯录列表(包含群聊)
      • 获取通讯录列表(包含群聊)缓存
      • 搜索好友
      • 添加好友/同意好友
      • 删除好友
      • 获取群/好友简要信息
      • 获取群/好友详细信息
      • 设置好友仅聊天
      • 检测好友关系
      • 设置好友备注
      • 获取手机通讯录
      • 上传手机通讯录
      • 同步企微好友
      • 获取企微好友详情
    • 群管理接口
      • 创建微信群
      • 修改群名称
      • 修改群备注
      • 修改我在群内的昵称
      • 邀请/添加 进群
      • 删除群成员
      • 退出群聊
      • 获取群信息
      • 获取群成员列表
      • 获取群成员详情
      • 设置群公告
      • 获取群公告
      • 同意进群
      • 添加群成员为好友
      • 获取群二维码
      • 群保存到通讯录
      • 管理员操作
      • 聊天置顶
      • 设置消息免打扰
      • 扫码进群
      • 确认进群申请
    • 消息模块
      • 下载
        • 下载图片
        • 下载语音
        • 下载视频
        • 下载emoji
        • cdn下载
      • 发送文字消息
      • 发送文件消息
      • 发送图片消息
      • 发送语音消息
      • 发送视频消息
      • 发送链接消息
      • 发送名片消息
      • 发送emoji消息
      • 发送appmsg消息
      • 发送小程序消息
      • 转发文件
      • 转发图片
      • 转发视频
      • 转发链接
      • 转发小程序
      • 撤回消息
    • 朋友圈模块
      • 点赞/取消点赞
      • 删除朋友圈
      • 设置朋友圈可见范围
      • 是否允许陌生人查看朋友圈
      • 设置某条朋友圈为隐私/公开
      • 下载朋友圈视频
      • 发送文字朋友圈
      • 发送图片朋友圈
      • 发送视频朋友圈
      • 发送链接朋友圈
      • 上传朋友圈图片
      • 上传朋友圈视频
      • 转发朋友圈
      • 自己的朋友圈列表
      • 联系人的朋友圈列表
      • 某条朋友圈详情
      • 评论/删除评论
    • 标签模块
      • 添加标签
      • 删除标签
      • 标签列表
      • 修改好友标签
    • 个人模块
      • 获取个人资料
      • 获取自己的二维码
      • 获取设备记录
      • 隐私设置
      • 修改个人信息
      • 修改头像
    • 收藏夹模块
      • 同步收藏夹
      • 获取收藏夹内容
      • 删除收藏夹
    • 视频号模块
      • 搜索视频号
        POST
      • 获取视频号信息
        POST
      • 创建视频号
        POST
      • 发私信文本消息
        POST
      • 发私信图片消息
        POST
      • 获取私信人详情
        POST
      • 获取私信SessionId
        POST
      • 扫码登录视频号助手
        POST
      • 视频-直接发布视频
        POST
      • 关注/取消关注
        POST
      • 获取用户主页
        POST
      • 获取自己赞和收藏
        POST
      • 视频-分享给好友
        POST
      • 视频-分享到朋友圈
        POST
      • 视频-评论列表
        POST
      • 视频-点赞
        POST
      • 视频-小红心
        POST
      • 视频-评论
        POST
      • 修改视频号资料
        POST
      • 视频-浏览
        POST
      • 关注列表
        POST
      • 获取消息列表
        POST
      • 我的二维码
        POST
      • 扫码关注
        POST
      • 扫码获取视频详情
        POST
      • 扫码点小红心
        POST
      • 扫码大拇指
        POST
      • 扫码浏览
        POST
      • 扫码评论
        POST
      • 同步私信消息(临时停用)
        POST
      • 视频-直接发布视频
        POST
      • 视频-CDN上传视频(1)
        POST
      • 视频-CDN异步上传视频
        POST
      • 视频-CDN异步查询
        POST
      • 视频-CDN发布视频(2)
        POST
  1. 视频号模块

获取用户主页

POST
/finder/userPage
基础API/视频号模块
本接口使用对方toUserName为v2开头
注:V2可在消息回调接口内取到(fromusername)
如果对方私信身份为视频号身份则返回V2开头、则可以获取。若私信身份为微信身份则返回为FV1开头,无法进行获取。。

请求参数

Header 参数
VideosApi-token
string 
必需
示例值:
{{VideosApi-token}}
Body 参数application/json
appId
string 
设备ID
必需
toUserName
string 
必需
用户的username
lastBuffer
string 
可选
首次传空,后续传接口返回的lastBuffer
maxId
integer 
可选
首次传0,后续传响应结果中最后一条的id
searchInfo
object 
可选
如果是通过搜索渠道获取用户主页,则把搜索接口返回的cookies、searchId传进来
cookies
string 
可选
searchId
string 
可选
示例
{
    "appId": "{{appid}}",
    "lastBuffer": "",
    "toUserName": "v2_060000231003b20faec8cae7811bcadcc904ef30b0770fd600f70cfec5c128fc2ef6421e0c7a@finder",
    "maxId": 0
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://api.videosapi.com/finder/v2/api/finder/userPage' \
--header 'VideosApi-token: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "{{appid}}",
    "lastBuffer": "",
    "toUserName": "v2_060000231003b20faec8cae7811bcadcc904ef30b0770fd600f70cfec5c128fc2ef6421e0c7a@finder",
    "maxId": 0
}'

返回响应

🟢200成功
application/json
Body
ret
integer 
必需
msg
string 
必需
data
object 
必需
object
array [object {36}] 
必需
finderUserInfo
object 
必需
contact
object 
用户信息
必需
feedsCount
integer 
必需
continueFlag
integer 
必需
是否可以翻页 是:1
lastBuffer
string 
必需
翻页的标识,请求翻页时会用到
friendFollowCount
integer 
好友关注数
必需
userTags
array[string]
必需
preloadInfo
object 
必需
privateLock
integer 
必需
liveDurationHours
integer 
必需
justWatch
object 
必需
ipRegionInfo
object 
地区信息
必需
mcnInfo
object 
必需
productInfo
object 
必需
示例
{
    "ret": 200,
    "msg": "操作成功",
    "data": {
        "object": [
            {
                "id": 14379133554206378000,
                "nickname": "苏生-服务支持",
                "username": "v2_060000231003b20faec8cae7811bcadcc904ef30b0770fd600f70cfec5c128fc2ef6421e0c7a@finder",
                "objectDesc": {
                    "description": "",
                    "media": [
                        {
                            "Url": "http://wxapp.tc.qq.com/251/20304/stodownload?encfilekey=oibeqyX228riaCwo9STVsGLPj9UYCicgttvzDicPxtLUK1Mnwm6rYabzqqibT9LsSXMYSYPV0UVmiaibvf0e7scdaQV6ajtXpK6BgQoeUEuPy8ibSiaSy87VbhWianUWUrQGaloGMGiatejfdN5cT0&bizid=1023&dotrans=0&hy=SH&idx=1&m=aab40d3465073a9c29c4e171def00b7e&wxampicformat=500",
                            "ThumbUrl": "http://wxapp.tc.qq.com/251/20350/stodownload?encfilekey=WTva9YVXqXcSUicrMCercmDHmKYPBXC7ePV8OE7k7cAJaZDnHpwbibWib7qmricaWHFyR3GjKb7EibTiaLOiaDFZmgibqm0dMLHIKZz5EorAyY5ypTFjHDwdj92P0Un9fSibQDHQT8jUVINwuFSk&bizid=1023&dotrans=0&hy=SH&idx=1&m=40e334927eb1f7a5232afb0736776a76&picformat=200&wxampicformat=501",
                            "MediaType": 2,
                            "VideoPlayLen": 0,
                            "Width": 904,
                            "Height": 1224,
                            "Md5Sum": "aab40d3465073a9c29c4e171def00b7e",
                            "FileSize": 0,
                            "Bitrate": 0,
                            "decodeKey": "881819874",
                            "urlToken": "&token=6xykWLEnztLFU5qOA2qKKevOHYmbmCFUd4tVjKf7fwK6zfmcbIgdiaricVk3LbBTMNHW5Tlmebr6a1lg5mB05BxsVysyozZTHgXpISicGDjDzFsFhevODHvAyvnummjJMJwoVHIsHpnRF8s5hWicYaRQHEOC9Ajqf3xSBadW2ISpXV4&basedata=CAASACIAKgUImB0QAA&sign=EyWgHb1jPRldeC4pftH2J3M7JvuBpK2xfkMlw21vV8jOo4bdlZDd0HJnHvGBJYbe9x3DIxy2ZjSmavbSzJIO0A&ctsc=32",
                            "thumbUrlToken": "&token=Cvvj5Ix3eeyD0TVgRZ2eE3Qoj53ibu5gDMDk1YO8gHI1akBmtxpFWdBdJg69NOzUBsSHsjK22ibSmqLtTJURmRpgwxVgLcvSsOrSdqhXoYqS5y15ibnNCLkqpfPCeicDDveuShFO1Mj1UTzwHgUBbTyXtbF8icV1KEXgj&ctsc=1-32",
                            "codecInfo": {
                                "videoScore": 0,
                                "videoCoverScore": 0,
                                "videoAudioScore": 0,
                                "thumbScore": 0,
                                "hdimgScore": 0,
                                "hasStickers": 0,
                                "useAlgorithmCover": 0
                            },
                            "hlsSpec": {},
                            "hotFlag": 0,
                            "halfRect": {
                                "left": 0,
                                "top": 333,
                                "right": 904,
                                "bottom": 890
                            },
                            "fullWidth": 0,
                            "fullHeight": 0,
                            "fullFileSize": 0,
                            "fullBitrate": 0,
                            "hdrSpec": {},
                            "cardShowStyle": 0,
                            "dynamicRangeType": 0,
                            "videoType": 0,
                            "duplicateFileSize": 0
                        }
                    ],
                    "mediaType": 2,
                    "extra": {},
                    "location": {
                        "longitude": 0,
                        "latitude": 0,
                        "poiClassifyType": 0
                    },
                    "extReading": {},
                    "feedLocation": {},
                    "imgFeedBgmInfo": {
                        "docId": "78240202873186745",
                        "albumThumbUrl": "http://wx.y.gtimg.cn/music/photo_new/T002R500x500M000002ZYHCj47dXDN_1.jpg",
                        "name": "满园春色惹人醉 (DJ版)",
                        "artist": "DJRE",
                        "albumName": "",
                        "mediaStreamingUrl": "http://wx.music.tc.qq.com/C400001MJxs61eCHGW.m4a?guid=2000000186&vkey=AA5B0E52406CF4995F71251A2058D95D14F5544C7F614F6C58C0D44AF02D9A98A743BE568DEDC9B1D96F80BCB07840884226AD5613FE56A2&uin=0&fromtag=30186&trace=0920fa4b25eaa560",
                        "musicPlayLen": 0,
                        "docType": 1,
                        "isTrySong": 0
                    },
                    "followPostInfo": {
                        "musicInfo": {
                            "docId": "78240202873186745",
                            "albumThumbUrl": "http://wx.y.gtimg.cn/music/photo_new/T002R500x500M000002ZYHCj47dXDN_1.jpg",
                            "name": "满园春色惹人醉 (DJ版)",
                            "artist": "DJRE",
                            "albumName": "",
                            "mediaStreamingUrl": "http://wx.music.tc.qq.com/C400001MJxs61eCHGW.m4a?guid=2000000186&vkey=AA5B0E52406CF4995F71251A2058D95D14F5544C7F614F6C58C0D44AF02D9A98A743BE568DEDC9B1D96F80BCB07840884226AD5613FE56A2&uin=0&fromtag=30186&trace=0920fa4b25eaa560",
                            "musicPlayLen": 0,
                            "docType": 1,
                            "isTrySong": 0
                        },
                        "groupId": "Listen_78240202873186745",
                        "hasBgm": 1
                    },
                    "fromApp": {
                        "appid": "",
                        "uiStyle": 0,
                        "extInfo": "",
                        "source": 0,
                        "sdkExtInfo": ""
                    },
                    "event": {
                        "eventTopicId": 0,
                        "eventName": "",
                        "eventCreatorNickname": "",
                        "eventAttendCount": 0,
                        "hiddenMark": 0
                    },
                    "draftObjectId": 0,
                    "clientDraftExtInfo": {
                        "waitType": 0
                    },
                    "generalReportInfo": {},
                    "posterLocation": {
                        "city": "Xuzhou City"
                    },
                    "finderNewlifeDesc": {}
                },
                "createtime": 1714126295,
                "forwardCount": 2,
                "contact": {
                    "username": "v2_060000231003b20faec8cae7811bcadcc904ef30b0770fd600f70cfec5c128fc2ef6421e0c7a@finder",
                    "nickname": "苏生-服务支持",
                    "headUrl": "https://wx.qlogo.cn/finderhead/ver_1/xV2hVfZ8cDEjCT2zGUBWSLYasZn8YuaHicLiagteZG0QI3Biby83nlPb7EFHEk4RA9zb8VZXGn6xaMgJgI6lPIB7ogDI5CiaPLzgccaeyqQ48V3EBl4tGXhZ9UKwOqvw5ubv/0",
                    "seq": 1,
                    "signature": "videosapi技术支持",
                    "followFlag": 0,
                    "authInfo": {},
                    "coverImgUrl": "",
                    "spamStatus": 0,
                    "extFlag": 262156,
                    "extInfo": {
                        "country": "CN",
                        "province": "Jiangsu",
                        "city": "Xuzhou",
                        "sex": 1
                    },
                    "liveStatus": 2,
                    "liveCoverImgUrl": "",
                    "liveInfo": {
                        "anchorStatusFlag": 2048,
                        "switchFlag": 119263,
                        "micSetting": {},
                        "lotterySetting": {
                            "settingFlag": 0,
                            "attendType": 4
                        }
                    },
                    "friendFollowCount": 1,
                    "oneTimeFlag": 2,
                    "status": 0,
                    "clubInfo": {}
                },
                "displayid": 14379133554206378000,
                "likeCount": 1,
                "commentCount": 6,
                "deletetime": 0,
                "objectNonceId": "11171020040813205610_0_32_2_2_1742215089869280",
                "objectStatus": 0,
                "sendShareFavWording": "",
                "originalFlag": 0,
                "secondaryShowFlag": 1,
                "sessionBuffer": "eyJjdXJfbGlrZV9jb3VudCI6MSwiY3VyX2NvbW1lbnRfY291bnQiOjYsInJlY2FsbF90eXBlcyI6W10sImRlbGl2ZXJ5X3NjZW5lIjoyLCJkZWxpdmVyeV90aW1lIjoxNzQyMjE1MDkwLCJzZXRfY29uZGl0aW9uX2ZsYWciOjksInJlY2FsbF9pbmRleCI6W10sInJlcXVlc3RfaWQiOjE3NDIyMTUwODk4NjkyODAsIm1lZGlhX3R5cGUiOjIsImNyZWF0ZV90aW1lIjoxNzE0MTI2Mjk1LCJyZWNhbGxfaW5mbyI6W10sInNlY3JldGVfZGF0YSI6IkJnQUFXSkhudzNkZkxTTDdLaXMxdjlMSXJack8xWStQc1NkVEpNbDBRZ1FYd04wRmU1TStjK2hIZlwvYlV5dENZcFFRZ1g3Mk15em89Iiwib2ZsYWciOjE2ODA5OTg0LCJ0YWJfc2Vzc2lvbl9pZCI6MTc0MjIxNTA4OTg4ODA2NiwiaWRjIjozLCJkZXZpY2VfdHlwZV9pZCI6MTMsImRldmljZV9wbGF0Zm9ybSI6ImlQYWQxMyw4IiwiZmVlZF9wb3MiOjAsImNsaWVudF9yZXBvcnRfYnVmZiI6IntcImlmX3NwbGl0X3NjcmVlbl9pcGFkXCI6MCxcImVudGVyU291cmNlSW5mb1wiOlwie1xcXCJmaW5kZXJ1c2VybmFtZVxcXCI6XFxcIlxcXCIsXFxcImZlZWRpZFxcXCI6XFxcIlxcXCJ9XCIsXCJleHRyYWluZm9cIjpcIntcXFwicmVnY291bnRyeVxcXCI6XFxcIkNOXFxcIn1cIixcInNlc3Npb25JZFwiOlwiU3BsaXRWaWV3RW1wdHlWaWV3Q29udHJvbGxlcl8xNzQyMjE1MDgxMTI3IyQwXzE3NDIyMTUwNjg0OTEjXCIsXCJqdW1wSWRcIjp7XCJ0cmFjZWlkXCI6XCJcIixcInNvdXJjZWlkXCI6XCJcIn19IiwiY29tbWVudF9zY2VuZSI6MzIsIm9iamVjdF9pZCI6MTQzNzkxMzM1NTQyMDYzNzgwMTksImdlb2hhc2giOjMzNzc2OTk3MjA1Mjc4NzIsInRhYl9mZWVkX3BvcyI6MCwiZW50cmFuY2Vfc2NlbmUiOjIsImNhcmRfdHlwZSI6MywiZXhwdF9mbGFnIjo4ODc4Nzk1NSwidXNlcl9tb2RlbF9mbGFnIjo4LCJpc19mcmllbmQiOnRydWUsImN0eF9pZCI6IjItMy0zMi0zN2ZmYmVhODlkNjBmMjUyZmIzMWM3NDYxMmY1YWVkNjE3NDIyMTUwODYyNTMiLCJhZF9mbGFnIjo0LCJlcmlsIjpbXSwicGdrZXlzIjpbXSwic2NpZCI6ImFmMGI3MmNhLTAzMmMtMTFmMC05ZjkyLWU1NjRkOTc0ZWQ4YiIsImNvbW1lbnRfdmVyIjoxNzQxMDg0MTc1fQ==",
                "favCount": 1,
                "urlValidTime": 172800,
                "forwardStyle": 0,
                "permissionFlag": 2147483656,
                "attachmentList": {},
                "objectType": 0,
                "followFeedCount": 0,
                "verifyInfoBuf": "CsADCmEKVMZ6O/DNYthI2bQM8nH1rZrrcpBrLlchNG+IX4ZYcf3eNoowK6PJIMGByiLmDBv/UXK8Ti8akeXKC+IC0L/4gEMHT89PoRpkbXcxElP33Vl3NzFRi7ypu9ktDrUoaoOyvQZkG5ULGxLXUI3BsaPHWRD8bSRTCskzNKaSmnsW3qoY0LsloureX9Dj4fLu7PsmiuSezrJy3UFS08HvWzRmVtqZlg8Dd0iR8C5bXlACEOZTQWo0oh7p+Wg/BKIAF0RdOX/nvyJVmL9VfLbnj/deNnnz45k1EBEeYoZJ6cGBHZPSry+4FD8B1hfqCpxxd7ryMOsndbU1KxYxksdhIiqOzpo5Vmm16lmUDSPmRvnnCL5IR/PpBzKgCFzHam1IPvDoEokwQCZqqz2kJdD5f7lEarbEBFSyQPBoDGJ7jCC8PbEPFJtiJo3dzl3SRoDsadKioPsJTx1bUfJFGrJw+oiWswcvfhgOBUOKkVeBQg1Z43p5TeX3ffUNCarjLx1reS1MqV+G5VbotBeHgGqgRYd5e2rKQx23HE7MjNGJ8y4rppGukYwOPeCKGWCqM5GqxITZAP3+NLxCj83LuEnmOA==",
                "wxStatusRefCount": 0,
                "adFlag": 4,
                "tipsInfo": {},
                "internalFeedbackUrl": "",
                "ringtoneCount": 0,
                "funcFlag": 256,
                "playhistoryInfo": {},
                "finderPromotionJumpinfo": {},
                "flowCardRecommandReason": {},
                "ipRegionInfo": {}
            }
        ],
        "finderUserInfo": {
            "coverImgUrl": ""
        },
        "contact": {
            "username": "v2_060000231003b20faec8cae7811bcadcc904ef30b0770fd600f70cfec5c128fc2ef6421e0c7a@finder",
            "nickname": "苏生-服务支持",
            "headUrl": "https://wx.qlogo.cn/finderhead/ver_1/xV2hVfZ8cDEjCT2zGUBWSLYasZn8YuaHicLiagteZG0QI3Biby83nlPb7EFHEk4RA9zb8VZXGn6xaMgJgI6lPIB7ogDI5CiaPLzgccaeyqQ48V3EBl4tGXhZ9UKwOqvw5ubv/0",
            "signature": "videosapi技术支持",
            "followFlag": 0,
            "authInfo": {},
            "coverImgUrl": "",
            "spamStatus": 0,
            "extFlag": 262156,
            "extInfo": {
                "country": "CN",
                "province": "Jiangsu",
                "city": "Xuzhou",
                "sex": 1
            },
            "liveStatus": 2,
            "liveCoverImgUrl": "",
            "liveInfo": {
                "anchorStatusFlag": 2048,
                "switchFlag": 119263,
                "micSetting": {},
                "lotterySetting": {
                    "settingFlag": 0,
                    "attendType": 4
                }
            },
            "oneTimeFlag": 2,
            "status": 0,
            "clubInfo": {}
        },
        "feedsCount": 1,
        "continueFlag": 0,
        "lastBuffer": "CKOQ/OKJubzGxwEQARgAIKOQ/OKJubzGxwEwADjCtrj8kJGMA0CAwJPy+IyPA0ijkPziibm8xscB",
        "userTags": [
            "55S3",
            "5rGf6IuPIOW+kOW3ng=="
        ],
        "preloadInfo": {
            "preloadStrategyId": 2381702531,
            "globalInfo": {
                "prevCount": 0,
                "nextCount": 5,
                "maxBitRate": 150,
                "preloadFileMinBytes": 0,
                "preloadMaxConcurrentCount": 1,
                "megavideoMaxBitRate": 150,
                "megavideoPrevCount": 1,
                "megavideoNextCount": 2,
                "minBufferLength": 25,
                "maxBufferLength": 30,
                "minCurrentFeedBufferLength": 5,
                "canPreCreatedPlayer": 0
            }
        },
        "liveDurationHours": 0,
        "justWatch": {
            "showJustWatch": 0,
            "allowPrefetch": 0
        },
        "ipRegionInfo": {},
        "mcnInfo": {
            "agencyName": "江苏"
        },
        "productInfo": {}
    }
}

产品可行性及API相关问题咨询

上一页
关注/取消关注
下一页
获取自己赞和收藏
Built with