上传附件

上传附件文件至系统。支持大文件分片上传，每次上传一个分片，全部上传完成后自动合并为完整文件。

接口地址：

text

/papi/file/uploadAttachment

请求方式：

text

POST

请求数据类型：

text

multipart/form-data

Header 参数：

参数	类型	必填	说明
X-Access-Key	string	是	API 访问密钥 ID，鉴权方式见接口规则
X-Signature	string	是	签名值，Base64 编码的 HMAC-SHA256 计算结果
X-Timestamp	string	是	毫秒级 Unix 时间戳（13 位）
X-Nonce	string	是	随机字符串，10~32 位小写字母+数字

Body 参数：

参数	类型	必填	说明
md5	string	是	文件 MD5 值
partNumber	integer	是	分片索引
file	file	是	分片文件流
totalChunks	integer	是	总分片数
fileSuffix	string	是	文件后缀名（包含点，如 .jpg）
fileName	string	是	文件名
totalSize	integer	是	文件总大小
targetPath	string	否	目录
ctrIds	array[string]	否	云机 ctrIds

注意： 此接口使用 multipart/form-data 格式提交。

请求示例：

text

md5: 24264aaf4064feb1f7e1fe8e6044aa3e
partNumber: 1
file: <binary>
totalChunks: 1
fileSuffix: .png
fileName: 3

响应参数：

参数	类型	说明
code	integer	错误码，参见错误码说明
data	object	返回数据
├─ md5	string	文件 MD5
├─ partNumber	integer	当前分片号
├─ uploadedChunks	array[string]	已上传的分片列表
├─ totalChunks	integer	总分片数
├─ url	string	文件 URL，仅在上传完成时返回
├─ appSid	string	-
msg	string	错误提示

响应示例：

json

{
    "code": 0,
    "data": {
        "md5": "",
        "partNumber": 0,
        "uploadedChunks": [""],
        "totalChunks": 0,
        "url": "",
        "appSid": ""
    },
    "msg": ""
}

上传附件 ​

上传附件