1. 分片文件块上传
查询md5值为{md5}的文件是否已经上传。
请求方式:POST
请求地址:/bosdocumentservice/{appkey}/files/sliceFile
1.1. 请求参数:
Headers:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
Authorization | string | c4570cb9ca324bc8ba7dd9d1967710ea | 是 | access_token |
PathParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
NULL | NULL | NULL | NULL | NULL |
SearchParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
NULL | NULL | NULL | NULL | NULL |
Body:
application/json:
from-data:
{
"file": "具体文件",
"sliceKey": "", //分片文档唯一标识
"fileMd5": "xsssdfsg3s3e", //分片文件块md5
"chunkNumber": 1, //当前文件块序号
"currentChunkSize": 1024 //当前文件块大小
}
1.2. 参数说明:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
file | string | NULL | NULL | 具体文件 |
sliceKey | string | NULL | 是 | 分片文档唯一标识 |
fileMd5 | string | xsssdfsg3s3e | 是 | 分片文件块md5 |
chunkNumber | string | 1 | 是 | 当前文件块序号 |
currentChunkSize | string | 1024 | 是 | 当前文件块大小 |
1.3. 正确返回:
Http Status Code:200
{
"code": "SUCCESS",
"message": "请求处理成功",
"data": null
}
1.4. 状态码:
状态码 | code | message | data | 原因 |
---|---|---|---|---|
200 | ENTITY_QUERY_SETTING_INVALID | 参数值file无效 | NULL | 当file对应文件体为空时 |
200 | OBJECT_FIELD_DATA_WRONG | sliceKey属性数据错误 | NULL | 当sliceKey对应缓存数据不存在时 |
200 | FILE_UPLOAD_ERROR | 文件上传错误 | NULL | 文件保存至文件服务器失败时 |
1.5. 注意事项:
1、根据sliceKey值在缓存数据中查询是否存在对应数据记录。
2、保存file文件至文件服务器,获取文件path。
3、保存文件块对应数据,如path,md5,size,chunkNumber等信息值sliceKey对应的缓存数据chunkList中。
4、返回结果。
5、存储的文件块也会跟随缓存数据定时清理任务一起被清除。