在鸿云文档

Appearance

HTTPS鸿蒙OTA升级 ​

概述 ​

HTTPS鸿蒙流式OTA升级接口，使用HTTP协议对鸿蒙进行OTA流式升级时使用，接口返回config.json下载路径。

接口地址 ​

../gateway/hmiot-ota-server/ota/harmony/upgrade

请求方式 ​

POST

请求数据类型 ​

Content-Type: application/json

请求示例 ​

json
{
	"productKey": "k3oI5JIbJ",
	"deviceName": "456",
	"timestamp": "1632445949000",
	"sign": "0077984C51823B2F621C296F867D9CA6",
	"signMethod": "hmacmd5",
	"version": "10.00.01"
}

请求参数说明 ​

参数名称类型
是否必选
描述
productKeyString是产品唯一标识。
deviceNameString是设备唯一标识。
timestampString否可选, 当前时间的时间戳。
signMethodString否可选, 签名方法，默认为:hmacmd5. 目前支持hmacmd5、hmacsha1、hmacsha256。
signString是签名。
加签方法：将提交给服务器的参数（sign、signMethod除外）按照顺序，然后将参数和值依次拼接（无拼接符号）。通过signMethod指定的加签算法，使用设备的deviceSecret，对加签内容进行加签。 加签计算示例如下：
hmac_md5(deviceSecret, deviceNamesn1234productKey8725timestamp163)。
当timestamp为空时,不参与加签算法,如:
hmac_md5(deviceSecret, deviceNamesn1234productKey8725)。
versionString是当前设备的版本号。

响应示例 ​

json
{
	"code": 200,
	"configUrl": "https://*******/gateway/f?attach_id=96c88a521ddc4f4b9bcd9656aa0c0361"
}

响应参数说明 ​

参数名称类型
是否必选
描述
codeint是200为成功。
-400:设备不存在
-401:签名错误
-402:没有升级任务
-403: 参数错误
configUrlString否config.json的下载url。