上传文件（图片/视频）
SDK 文档
apifm
开发参考
如有可能，尽量在前端将图片、视频进行压缩后再上传，可以减少图片和视频的容量，加快加载速度，减少存储容量：
微信小程序图片可使用 [https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.compressImage.html](https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.compressImage.html)
微信小程序视频可使用
[https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.compressVideo.html](https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.compressVideo.html)
uni-app 对应的是 `uni.compressImage`和 `uni.compressVideo`
H5可以使用对应的 npm 组件，原生 app 等其他方式可以使用相应的解决方案
# 上传本地文件
```javascript
WXAPI.uploadFileV2(token, tempFilePath, expireHours)
```
+ token 登陆用户token
+ tempFilePath 本地文件的临时路径，获取方法见下面详细说明
+ expireHours 该参数可不传，如果传了，该文件将会在指定的n小时后自动删除掉
```json
{
"code": 0,
"data": {
"msg": "SUCCESS",
"originalName": "KxwOAEbRr12j7f9cb25ea21c76ddf12d48994d78b1f3.jpeg",
"size": "113718",
"name": "cuser/951/2021/12/15/c365b6cb-f688-4298-8455-2e57a63d4bc5.jpeg",
"id": "2281997",
"type": ".jpeg",
"url": "https://7.s2m.cc/cuser/951/2021/12/15/c365b6cb-f688-4298-8455-2e57a63d4bc5.jpeg"
},
"msg": "success"
}
```
+ originalName 原始文件名
+ size 文件容量（Byte）
+ url 图片地址
## 微信小程序获取 tempFilePath
[https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.chooseImage.html](https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.chooseImage.html)
## 头条小程序获取 tempFilePath
[https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/media/picture/tt-choose-image](https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/media/picture/tt-choose-image)
## uni-app获取 tempFilePath
[https://uniapp.dcloud.io/api/media/image?id=chooseimage](https://uniapp.dcloud.io/api/media/image?id=chooseimage)
# 下载图片地址并上传
```javascript
WXAPI.uploadFileFromUrlV2({
remoteFileUrl: 'http://.............jpg',
ext: '.jpg',
expireHours: 1
})
```
+ remoteFileUrl 图片的远程访问地址
+ ext 文件后缀名 ， 如： .jpg
+ expireHours 多少小时后自动删除该图片，不传该参数则不删除
```json
{
"code": 0,
"data": {
"msg": "SUCCESS",
"originalName": "KxwOAEbRr12j7f9cb25ea21c76ddf12d48994d78b1f3.jpeg",
"size": "113718",
"name": "cuser/951/2021/12/15/c365b6cb-f688-4298-8455-2e57a63d4bc5.jpeg",
"id": "2281997",
"type": ".jpeg",
"url": "https://7.s2m.cc/cuser/951/2021/12/15/c365b6cb-f688-4298-8455-2e57a63d4bc5.jpeg"
},
"msg": "success"
}
```
+ originalName 原始文件名
+ size 文件容量（Byte）
+ url 图片地址
# 获取上传的文件列表
## v2版本
```javascript
WXAPI.uploadFileListV2({
path: 'abc'
})
```
+ path 默认传空，将会获取根目录的文件，如果要获取指定目录下的文件，传具体目录即可
## v1版本【请尽快升级到v2版本】
```javascript
WXAPI.uploadFileList(path)
```
+ path 默认传空，将会获取根目录的文件，如果要获取指定目录下的文件，传具体目录即可
```json
{
"code": 0,
"data": {
"baseUrl": "https://7.s2m.cc",
"qiniuFiles": [
{
"fsize": 156484,
"hash": "Fhp9s8IMXY9kTW625d92MqU5azho",
"key": "cuser/951/2021/09/30/26fe080c-2a84-49c2-b0f7-6a7be3b66377.jpg",
"md5": "0053aa6345b18e69aab9e371b6498ba7",
"mimeType": "image/jpeg",
"putTime": 16329748092688291,
"status": 0,
"type": 0
}
]
},
"msg": "success"
}
```
# 拉取图库图片列表
```javascript
WXAPI.galleryList({
page: 1
})
```
+ page 获取第几页数据，不传该参数默认为1
+ pageSize 每页获取几条记录，不传该参数默认为50
+ categoryId 图库ID
```json
{
"code": 0,
"data": {
"result": [
{
"dateAdd": "2022-10-26 21:48:58",
"fileType": 0,
"fileTypeStr": "图片",
"originalName": "21.jpg",
"protect": false,
"size": 94334,
"sizeStr": "92.12 KB",
"suffix": ".jpg",
"urlFull": "https://dcdn.it120.cc/2022/10/26/3391d55b-4e18-4233-a6e0-cdcd0be8eba5.jpg",
"urlNoDomain": "2022/10/26/3391d55b-4e18-4233-a6e0-cdcd0be8eba5.jpg"
}
],
"totalPage": 1,
"totalRow": 21
},
"msg": "success"
}
```