更新时间:2023-06-16 GMT+08:00
分享

文件上传归一化

功能介绍

文件上传归一化

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v2/fileservice/file/upload

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

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必传一个

表2 FormData参数

参数

是否必选

参数类型

描述

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

表3 响应Body参数

参数

参数类型

描述

result

Object

返回值

status

String

状态

状态码: 401

表4 响应Body参数

参数

参数类型

描述

error_msg

String

错误描述

error_code

String

错误码

状态码: 403

表5 响应Body参数

参数

参数类型

描述

error_msg

String

错误描述

error_code

String

错误码

状态码: 404

表6 响应Body参数

参数

参数类型

描述

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

错误码

请参见错误码

相关文档