WTAPI开发文档
  1. 下载
  • 平台简介
  • 快速入门
  • 接入开发规范
  • 消息订阅收发
  • 综合问题排查
  • 回调信息速览
  • 回调消息详解
  • 更新日志
  • API模块
    • 登录接口
      • ①获取登录二维码
      • ②执行登录
      • 弹窗登录
      • ③设置回调地址
      • 检查是否在线
      • 退出
      • 断线重连
    • 联系人接口
      • 获取通讯录列表
      • 获取通讯录列表缓存
      • 获取群/好友简要信息
      • 获取群/好友详细信息
      • 搜索好友
      • 添加联系人/同意添加好友
      • 删除好友
      • 设置好友仅聊天
      • 设置好友备注
      • 获取手机通讯录
      • 上传手机通讯录
      • 搜索企微
      • 添加企微好友
      • 同步企微好友
      • 获取企微好友详情
    • 消息接口
      • 下载
        • 下载文件
          POST
        • 下载图片
          POST
        • 下载语音
          POST
        • 下载视频
          POST
        • 下载emoji和表情包
          POST
      • 发送文字消息
        POST
      • 发送文件消息
        POST
      • 发送图片消息
        POST
      • 发送语音消息
        POST
      • 发送视频消息
        POST
      • 发送链接消息
        POST
      • 发送名片消息
        POST
      • 发送emoji消息
        POST
      • 发送appmsg消息
        POST
      • 发送小程序消息
        POST
      • 转发文件
        POST
      • 转发图片
        POST
      • 转发视频
        POST
      • 转发链接
        POST
      • 转发小程序
        POST
      • 撤回消息
        POST
    • 个人接口
      • 获取个人资料
      • 获取自己的二维码
      • 获取设备记录
      • 隐私设置
      • 修改个人信息
      • 修改头像
    • 标签接口
      • 添加标签
      • 删除标签
      • 标签列表
      • 修改好友标签
    • 群聊接口
      • 创建微信群
      • 修改群名称
      • 修改群备注
      • 修改我在群内的昵称
      • 邀请/添加 进群
      • 删除群成员
      • 退出群聊
      • 解散群聊
      • 获取群信息
      • 获取群成员列表
      • 获取群成员详情
      • 设置群公告
      • 获取群公告
      • 同意进群
      • 添加群成员为好友
      • 获取群二维码
      • 群保存到通讯录
      • 管理员操作
      • 聊天置顶
      • 设置消息免打扰
      • 扫码进群
      • 确认进群申请
    • 朋友圈接口
      • 自己的朋友圈列表
      • 联系人的朋友圈列表
      • 点赞/取消点赞
      • 删除自己朋友圈
      • 设置朋友圈可见范围
      • 是否允许陌生人查看朋友圈
      • 设置某条朋友圈为隐私/公开
      • 下载朋友圈视频
      • 发送文字朋友圈
      • 发送图片朋友圈
      • 发送视频朋友圈
      • 发送链接朋友圈
      • 上传朋友圈图片
      • 上传朋友圈视频
      • 转发朋友圈
      • 某条朋友圈详情
      • 评论/删除评论
    • 收藏夹接口
      • 同步收藏夹
      • 获取收藏夹内容
      • 删除收藏夹
    • 视频号接口
      • 获取我的视频号信息
      • 修改我的视频号信息
      • 用户主页
      • 关注
      • 评论
      • 浏览
      • 发布视频-新
      • 关注列表
      • 消息列表
      • 评论列表
      • 获取赞与收藏的视频列表
      • 搜索视频号
      • 创建视频号
      • 同步私信消息
      • 根据id点赞
      • 根据id点小红心
      • 发送视频号消息
      • 发送视频号朋友圈
      • 获取私信人信息
      • 发私信文本消息
      • 发私信图片消息
      • 扫码关注
      • 搜索并关注
      • 扫码浏览
      • 扫码评论
      • 扫码点赞
      • 扫码点小红心
      • 延迟点赞、小红心
      • 扫码登录视频号助手
      • 扫码获取视频详情
      • 我的视频号二维码
      • 上传CDN视频
      • 发布CDN视频
  1. 下载

下载文件

POST
/finder/v2/api/message/downloadFile

请求参数

Header 参数

Body 参数application/json

示例
{
    "appId": "{{appid}}",
    "xml": "<?xml version=\"1.0\"?>\n<msg>\n\t<appmsg>\n\t\t<title>log_20260518.txt</title>\n\t\t<type>6</type>\n\t\t<appattach>\n\t\t\t<totallen>1166</totallen>\n\t\t\t<attachid>@cdn_3057020100044b304902010002048b061c0002032f57ed02049f88e67202046a0bfcd6042430393831643539302d346136662d346535382d393034392d6462623466373632653032380204051400050201000405004c4e6100_e6c413884586171496f5315ebcabbbc3_1</attachid>\n\t\t\t<cdnattachurl>3057020100044b304902010002048b061c0002032f57ed02049f88e67202046a0bfcd6042430393831643539302d346136662d346535382d393034392d6462623466373632653032380204051400050201000405004c4e6100</cdnattachurl>\n\t\t\t<aeskey>e6c413884586171496f5315ebcabbbc3</aeskey>\n\t\t\t<fileext>txt</fileext>\n\t\t\t<overwrite_newmsgid>958036977603034497</overwrite_newmsgid>\n\t\t\t<fileuploadtoken><![CDATA[v1_wjmbpLIyiKUgU1XJrV1cntgb0/WZD8AT2iw8Y33YFztnONMQ2UbR3rIX6aQS5RN3LnnqSqC+LEsQCZePFW1JRSi25m5H6GYfj3McMHZ/wfh/lmCdR8KnFin1LYLVwVZfQvLcw/mgN1pO6qojiZv+6krY9NL9s5YX3ninX22mKwDOpFWzseVPs1bMKV6usc+9VqijLLu2pAIUQrgXnY9R]]></fileuploadtoken>\n\t\t</appattach>\n\t\t<md5>059fe6b972e76bdbb62af5130b5252fd</md5>\n\t</appmsg><extcommoninfo>\n\t<media_expire_at>1780380118</media_expire_at>\n</extcommoninfo>\n\n\t<fromusername>wxid_tyyu4v9ykz3712</fromusername>\n\t<scene>0</scene>\n\t<appinfo>\n\t\t<version>1</version>\n\t\t<appname></appname>\n\t</appinfo>\n\t<commenturl></commenturl>\n</msg>\n"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://wx.chuapi.com/finder/v2/api/message/downloadFile' \
--header 'X-finder-TOKEN: ' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6IjAxNmM2ZDQ5LWIxNWMtNGRjMy05YzQzLWZmYzZmNDhhMTg3MyJ9.1JWq9ntjam20_XDlSbklWTxbV-vg-F_dY1LYVX05BndRAuaJbv3iSwoDY-BuMwe1sdKxDXtDTMWJgXNMff4nOg' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "{{appid}}",
    "xml": "<?xml version=\"1.0\"?>\n<msg>\n\t<appmsg>\n\t\t<title>log_20260518.txt</title>\n\t\t<type>6</type>\n\t\t<appattach>\n\t\t\t<totallen>1166</totallen>\n\t\t\t<attachid>@cdn_3057020100044b304902010002048b061c0002032f57ed02049f88e67202046a0bfcd6042430393831643539302d346136662d346535382d393034392d6462623466373632653032380204051400050201000405004c4e6100_e6c413884586171496f5315ebcabbbc3_1</attachid>\n\t\t\t<cdnattachurl>3057020100044b304902010002048b061c0002032f57ed02049f88e67202046a0bfcd6042430393831643539302d346136662d346535382d393034392d6462623466373632653032380204051400050201000405004c4e6100</cdnattachurl>\n\t\t\t<aeskey>e6c413884586171496f5315ebcabbbc3</aeskey>\n\t\t\t<fileext>txt</fileext>\n\t\t\t<overwrite_newmsgid>958036977603034497</overwrite_newmsgid>\n\t\t\t<fileuploadtoken><![CDATA[v1_wjmbpLIyiKUgU1XJrV1cntgb0/WZD8AT2iw8Y33YFztnONMQ2UbR3rIX6aQS5RN3LnnqSqC+LEsQCZePFW1JRSi25m5H6GYfj3McMHZ/wfh/lmCdR8KnFin1LYLVwVZfQvLcw/mgN1pO6qojiZv+6krY9NL9s5YX3ninX22mKwDOpFWzseVPs1bMKV6usc+9VqijLLu2pAIUQrgXnY9R]]></fileuploadtoken>\n\t\t</appattach>\n\t\t<md5>059fe6b972e76bdbb62af5130b5252fd</md5>\n\t</appmsg><extcommoninfo>\n\t<media_expire_at>1780380118</media_expire_at>\n</extcommoninfo>\n\n\t<fromusername>wxid_tyyu4v9ykz3712</fromusername>\n\t<scene>0</scene>\n\t<appinfo>\n\t\t<version>1</version>\n\t\t<appname></appname>\n\t</appinfo>\n\t<commenturl></commenturl>\n</msg>\n"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "ret": 200,
    "msg": "操作成功",
    "data": {
        "fileUrl": "http://wxapii.oos-sccd.ctyunapi.cn/20260519/wx_e2PiMSX8ySDV6tQGroCDc/910b2058-9d8c-4f88-8c48-0399571c1f8c.txt?AWSAccessKeyId=9e882e7187c38b431303&Expires=1779775693&Signature=kz3RYGcw6HHoRS8YGUD2Vdfm90Q%3D"
    }
}
修改于 2026-05-19 06:12:09
上一页
获取企微好友详情
下一页
下载图片
Built with