文件上传归一化
功能介绍
文件上传归一化
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v2/fileservice/file/upload
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
否 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 x-publisher-token和X-Auth-Token必传一个 |
x-publisher-token |
否 |
String |
发布商凭证,x-publisher-token和X-Auth-Token必传一个 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
file |
是 |
File |
文件 |
publisher_id |
否 |
String |
传用户token时,此字段为必传项 |
chunk_index |
是 |
Long |
分片索引,第几个分片 取值范围:1-100 |
merge |
是 |
Boolean |
是否合并已上传的分片(包含本次分片内容),true |
total_chunk_num |
是 |
Long |
总分片数 0-100 |
parent_file_size |
是 |
Long |
父文件大小 |
parent_file_name |
是 |
String |
父文件名称 |
override |
是 |
Boolean |
是否覆盖原有文件 |
chunk_md5 |
是 |
String |
文件分片的md5,用于校验文件分片是否完整 |
parent_file_sha256 |
否 |
String |
父文件hash,用于校验合并后的文件 |
task_id |
否 |
String |
上传任务的唯一标识,第一次上传分片时可不传 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
result |
Object |
返回值 |
status |
String |
状态 |
状态码: 401
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
错误描述 |
error_code |
String |
错误码 |
状态码: 403
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
错误描述 |
error_code |
String |
错误码 |
状态码: 404
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
错误描述 |
error_code |
String |
错误码 |
请求示例
文件上传归一化
POST https://{endpoint}/v1/fileservice/file/upload
响应示例
状态码: 200
OK
{ "result" : { "task_id" : "597a3fc9-a023-48fa-93bd-14386bf5936b" }, "status" : "success" }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
201 |
Created |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not Found |
错误码
请参见错误码。