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

同步私信消息

POST
/finder/syncPrivateLetterMsg
基础API/视频号模块
如果同步私信时对方发送的私信类型为图片、视频、语音、emoji时，可以通过消息下载接口将信息下载。
下载图片、下载语音、下载视频、下载emoji、通用CDN下载

请求参数

Header 参数
VideosApi-token
string 
必需
示例值:
{{VideosApi-token}}
Body 参数application/json
appId
string 
设备ID
必需
keyBuff
string 
可选
首次传空，后续传接口返回的keyBuff
示例
{
  "appId": "{{appid}}",
  "keyBuff": ""
}

示例代码

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.videostui.com/finder/v2/api/finder/syncPrivateLetterMsg' \
--header 'VideosApi-token: {{VideosApi-token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "{{appid}}",
    "keyBuff": ""
}'

返回响应

🟢200成功
application/json
Body
ret
integer 
必需
msg
string 
必需
data
object 
必需
list
array [object {4}] 
必需
keyBuff
string 
必需
翻页key，请求翻页时会用到
示例
{
  "ret": 200,
  "msg": "操作成功",
  "data": {
    "list": [
      {
        "syncKeyType": 1,
        "itemType": 1,
        "content": {
          "msg": {
            "MsgId": 1,
            "FromUserName": {
              "string": "wxid_0xsqb3o0tsvz22"
            },
            "ToUserName": {
              "string": "v2_060000231003b20faec8c6e18f10c7d6c903ec3db0776955d3d97c6b329d6aa58693bcdb7ad1@finder"
            },
            "MsgType": 1,
            "Content": {
              "string": "1"
            },
            "Status": 3,
            "ImgStatus": 1,
            "ImgBuf": {
              "iLen": 0
            },
            "CreateTime": 1706084719,
            "MsgSource": "<msgsource><pua>1</pua></msgsource>",
            "NewMsgId": 5871873953492479000,
            "MsgSeq": 1
          },
          "msgSessionId": "ee06e16a186756394a271218d7dd31f65d3d6aa43dc02a1ec23758f588836d53@findermsg",
          "seq": 1,
          "extinfo": "CAEQAQ==",
          "isSender": 1
        },
        "subType": 0
      },
      {
        "syncKeyType": 5,
        "itemType": 1,
        "content": {
          "msg": {
            "MsgId": 2,
            "FromUserName": {
              "string": "v2_060000231003b20faec8c6e18f10c7d6c903ec3db0776955d3d97c6b329d6aa58693bcdb7ad1@finder"
            },
            "ToUserName": {
              "string": "v2_060000231003b20faec8c7e28811c4d5cc0ded37b0779c48c759a7446a87688c2774e5300c32@finder"
            },
            "MsgType": 1,
            "Content": {
              "string": "12"
            },
            "Status": 3,
            "ImgStatus": 1,
            "ImgBuf": {
              "iLen": 0
            },
            "CreateTime": 1706084785,
            "MsgSource": "<msgsource><bizflag>0</bizflag><pua>1</pua></msgsource>",
            "NewMsgId": 1054704077635816600,
            "MsgSeq": 2
          },
          "msgSessionId": "3eab1521919d4531c83a166faa56cf844737c4a295b127f3edcb68ed4375d049@findermsg",
          "seq": 2,
          "extinfo": "CAEQAQ==",
          "isSender": 0
        },
        "subType": 2
      },
      {
        "syncKeyType": 5,
        "itemType": 1,
        "content": {
          "msg": {
            "MsgId": 3,
            "FromUserName": {
              "string": "v2_060000231003b20faec8c7e28811c4d5cc0ded37b0779c48c759a7446a87688c2774e5300c32@finder"
            },
            "ToUserName": {
              "string": "v2_060000231003b20faec8c6e18f10c7d6c903ec3db0776955d3d97c6b329d6aa58693bcdb7ad1@finder"
            },
            "MsgType": 1,
            "Content": {
              "string": "文本"
            },
            "Status": 3,
            "ImgStatus": 1,
            "ImgBuf": {
              "iLen": 0
            },
            "CreateTime": 1706084840,
            "MsgSource": "",
            "NewMsgId": 243683914400108300,
            "MsgSeq": 3
          },
          "msgSessionId": "3eab1521919d4531c83a166faa56cf844737c4a295b127f3edcb68ed4375d049@findermsg",
          "seq": 3,
          "extinfo": "CAIQAw==",
          "isSender": 1
        },
        "subType": 2
      },
      {
        "syncKeyType": 5,
        "itemType": 1,
        "content": {
          "msg": {
            "MsgId": 4,
            "FromUserName": {
              "string": "v2_060000231003b20faec8c7e28811c4d5cc0ded37b0779c48c759a7446a87688c2774e5300c32@finder"
            },
            "ToUserName": {
              "string": "v2_060000231003b20faec8c6e18f10c7d6c903ec3db0776955d3d97c6b329d6aa58693bcdb7ad1@finder"
            },
            "MsgType": 1,
            "Content": {
              "string": "文本"
            },
            "Status": 3,
            "ImgStatus": 1,
            "ImgBuf": {
              "iLen": 0
            },
            "CreateTime": 1706084898,
            "MsgSource": "",
            "NewMsgId": 7648226390526412000,
            "MsgSeq": 4
          },
          "msgSessionId": "3eab1521919d4531c83a166faa56cf844737c4a295b127f3edcb68ed4375d049@findermsg",
          "seq": 4,
          "extinfo": "CAIQAw==",
          "isSender": 1
        },
        "subType": 2
      },
      {
        "syncKeyType": 5,
        "itemType": 1,
        "content": {
          "msg": {
            "MsgId": 5,
            "FromUserName": {
              "string": "v2_060000231003b20faec8c7e28811c4d5cc0ded37b0779c48c759a7446a87688c2774e5300c32@finder"
            },
            "ToUserName": {
              "string": "v2_060000231003b20faec8c6e18f10c7d6c903ec3db0776955d3d97c6b329d6aa58693bcdb7ad1@finder"
            },
            "MsgType": 3,
            "Content": {
              "string": "<?xml version=\"1.0\"?>\n<msg>\n\t<img aeskey=\"38bd282fa5b21a42590269084f95975f\" encryver=\"1\" cdnthumbaeskey=\"38bd282fa5b21a42590269084f95975f\" cdnthumburl=\"3057020100044b30490201000204e49785f102032f5b0d0204e0689377020465b0cae1042436626432326532302d363466332d346135612d383238312d6636303061333033623762620204051438010201000405004c4c6d00\" cdnthumblength=\"1315\" cdnthumbheight=\"120\" cdnthumbwidth=\"120\" cdnmidheight=\"0\" cdnmidwidth=\"0\" cdnhdheight=\"0\" cdnhdwidth=\"0\" cdnmidimgurl=\"3057020100044b30490201000204e49785f102032f5b0d0204e0689377020465b0cae1042436626432326532302d363466332d346135612d383238312d6636303061333033623762620204051438010201000405004c4c6d00\" length=\"22001\" cdnbigimgurl=\"3057020100044b30490201000204e49785f102032f5b0d0204e0689377020465b0cae1042436626432326532302d363466332d346135612d383238312d6636303061333033623762620204051438010201000405004c4c6d00\" hdlength=\"1096\" md5=\"704de7ebbc107a51a4f0986253a6d3b6\" />\n\t<platform_signature></platform_signature>\n\t<imgdatahash></imgdatahash>\n</msg>\n"
            },
            "Status": 3,
            "ImgStatus": 2,
            "ImgBuf": {
              "iLen": 0
            },
            "CreateTime": 1706085089,
            "MsgSource": "<msgsource><bizflag>0</bizflag></msgsource>",
            "NewMsgId": 7744705344788547000,
            "MsgSeq": 5
          },
          "msgSessionId": "3eab1521919d4531c83a166faa56cf844737c4a295b127f3edcb68ed4375d049@findermsg",
          "seq": 5,
          "extinfo": "CAIQAw==",
          "isSender": 1
        },
        "subType": 2
      }
    ],
    "keyBuff": "CgQIARABCgQIAhAACgQIAxAACgQIBBAACgQIBRAFCgQIBhAACgQIBxAACgQICBAACgQICRAACgQIDBAAEAA="
  }
}

添加客服微信

其他API相关问题咨询

扫码加好友
修改于 2024-08-16 07:17:07
上一页
获取视频号信息
下一页
获取用户主页
Built with