oss-api
分为server和node
全局返回值result
code | data | msg |
---|---|---|
状态码 | 返回的数据 | 提示/失败的消息 |
code:1为成功,0为失败,其他请看具体接口
备注
serverAddr:目前部署的测试项目https://oss.lgeclub.cn
测试用户:id=2&password=testoss
测试demo:https://ossdemo.lgeclub.cn/
文件上传
1.获取上传会话
GET serverAddr/user/getUpload?id=userid&password=password&fileName=fileName&fileSize=24&md5=md5
id | password | |
---|---|---|
用户id | 密码 |
fileName | fileSize | md5 |
---|---|---|
文件名 | 文件大小 | 文件的md5(可选) |
文件大小单位为字节(b),如fileSize=1024代表文件大小1Kb
result示例:
{
"code": 1,
"msg": null,
"data": "https://1001.node.lgeclub.cn:50248/user/upload/1714789613",
"map": {}
}
code:1为成功,0为失败
msg:失败提示
data:获取到的上传会话
2.文件上传
POST nodeAddress/user/upload/?isSplit=true&index=1&total=10
获取上传会话时已经返回了nodeAddress/user/upload/部分
(https://1001.node.lgeclub.cn:50248/user/upload/1714789613)
isSplit | index | total |
---|---|---|
是否分片上传(true/false) | 当前第几个分片(起始值1) | 总分片数 |
不分片上传时,index和total不传
requstBody
form-data
proposeFile | ||
---|---|---|
具体的文件/文件分片 |
result示例:
{
"code": 1,
"msg": null,
"data": {
"id": "1684470354065498114",
"size": 528,
"name": "cpuz.ini",
"userId": 2,
"md5": null,
"updateTime": "2023-07-27T07:47:24.440+00:00",
"code": 200,
"remainingData": null
},
"map": {}
}
上传成功,R.code=1
R.data:文件的信息,注意保存文件id,其他数据按需保存
上传失败,R.code=0,R.msg=失败提示
文件已存在,R.code=4000
文件已存在但md5不一致,R.code=4004,R.data=计算出文件的Md5
文件上传完成但是md5对比失败,R.code=4004,R.data=计算出文件的Md5
分片上传成功但文件总体没完成,R.code=4001
分片重复/分片丢失(分片上传完毕进行文件合并时发现缺少分片)
R.code=4002,R.data=缺少的分片编号
分片上传失败,R.code=4003
分片合并完成,md5比对通过,R.code=1
文件下载
GET serverAddress/user/getDownload/?id=userID&password=PASSOWRD
fileId | id | password |
---|---|---|
文件id | 用户id | 密码 |
{
"code": 1,
"msg": null,
"data": "https://1001.node.lgeclub.cn:50248/user/download/-2084623343",
"map": {}
}
r.data为文件的下载链接,可直接访问
下载链接过期时间为3小时或者下载的数据量达到15gb自动过期(防止刷流量)
文件删除
serverAddress/user/delete/?id=userID&password=PASSOWRD
fileId | id | password |
---|---|---|
文件id | 用户id | 密码 |
{
"code": 1,
"msg": null,
"data": "删除成功",
"map": {}
}