文件上传

上传文件是指设备端通过HTTP通道上传较大文件，因为MQTT对消息大小有一定的限制，上传文件包括视频截取文件、历史消息数据、离线数据等。

文件上传注意事项

使用HTTPS协议，支持TLS V1.2版本；
CA证书为国际授信的域名证书，也可以直接下载CA证书；

具体流程

设备上传文件的流程如下所示：

获取上传文件目标URL；

设备端HTTP请求获取上传文件的目标URL以及上传文件的Authorization

POST //api/v1/url HTTP/1.1
Host: file-cn-sh2.iot.ucloud.cn
Content-Type: application/json
body: {"ProductSN":"ZG1EvTEa7NN","DeviceSN":"NlwaSPXsCpTQuh8FxBGH","DeviceSecret":"tepfnobkoyl4qgov","FileName":"file1.txt","FileSize":102654,"MD5":"dddddd","Content-Type":"text/plain"}

参数说明

参数	说明
Method	请求方法。只支持 POST 方法。
URL	/auth，URL 地址
Host	endpoint 地址
Content-Type	body 数据的编码格式。目前只支持 application/json
body	设备认证信息。JSON 数据格式。具体信息，请参见下表 body 参数。

body参数

参数名称	必选	类型	描述
ProductSN	是	string	产品序列号
DeviceSN	是	string	设备序列号
DeviceSecret	是	string	设备密码
FileName	是	string	文件名称
FileSize	是	int	文件大小
MD5	是	string	文件的MD5
Content-Type	否	string	文件数据的编码格式，比如application/zip等。默认为 text/plain

返回

{
  "RetCode": 0,
  "URL": "https://uiotcore-55977351-55738012.cn-sh2.ufileos.com/ProductSN/DeviceSN/fileName",
  "Authorization": "Ucloud eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJEZXZpY2VTTiI6InRlc3QxIiwiUHJvZHVjdFNOIjoiZzR3ZmFycTMweXp4YXkyMyIsImV4cCI6MTU2NzA1ODg5OSwiaWF0IjoxNTY2NDU0MDk5fQ.wN1XNVciI27nTeIqCjbYKdmTaifJrGJm_DmDDpIoabs"
}

2. 设备根据URL和Authorization上传文件；

PUT  HTTP/1.1

参数说明

参数	说明
Method	请求方法。只支持 PUT 方法。
URL	url，请求上传文件返回的 URL 地址

Header参数

参数	说明	必填项
Authorization	请求上传文件返回的Authorization	必填
Content-Type	文件数据的编码格式，比如application/zip等。默认为 text/plain	必填
Content-MD5	文件数据的MD5	必填

Body参数

参数	说明	必填项
Body	上传文件的数据	必填

返回参数

- status为200时返回空json

- 其他返回

{
  "RetCode": xxx,
  "ErrMsg": "xxxxxxxx"
}

其中RetCode参考UFile 错误码列表。

文档中心

文件上传

文件上传注意事项

具体流程