oss-api

分为server和node

全局返回值result

codedatamsg
状态码返回的数据提示/失败的消息

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

idpassword
用户id密码
fileNamefileSizemd5
文件名文件大小文件的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)

isSplitindextotal
是否分片上传(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

fileIdidpassword
文件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

fileIdidpassword
文件id用户id密码
{
    "code": 1,
    "msg": null,
    "data": "删除成功",
    "map": {}
}