對待升級設備進行確認操作，用于需要客戶端進行人為確認方可進行升級的場景。

路徑 /living/ota/confirm
版本號 1.0.0
協(xié)議 HTTPS
請求方法 POST
是否需要用戶身份鑒權 是
超時時間 25000

請求參數(shù)

名稱 類型 是否必選 示例值 描述
devices List 是 [{"iotId":"7bvbyRItBXQxxxxxxQt9X00109ea700"}, {"iotId":"7bvbyRItBXQxxxxxxQt9X00109ea711"}] 要進行升級確認的設備列表，設備列表中一次最多允許操作20個設備。
iotId String 否 7bvbyRItBXQxxxxxxQt9X00109ea700 設備的ID，生活物聯(lián)網(wǎng)平臺為設備頒發(fā)的ID，設備的唯一標識符。產(chǎn)品的Key或設備名稱為空時，該參數(shù)不允許為空。設備ID、產(chǎn)品的Key和設備名稱若同時填寫，以設備ID為準。
productKey String 否 a1LxxxxXUqY 產(chǎn)品的Key，設備證書信息之一。創(chuàng)建產(chǎn)品時，生活物聯(lián)網(wǎng)平臺為該產(chǎn)品頒發(fā)的全局唯一標識。設備ID為空時，該參數(shù)不允許為空。設備ID、產(chǎn)品的Key和設備名稱若同時填寫，以設備ID為準。
deviceName String 否 wt0jxxxxxxxnU0pc4AHX 設備的名稱，設備證書信息之一。在注冊設備時，自定義的或系統(tǒng)生成的設備名稱，具備產(chǎn)品維度內(nèi)的唯一性。設備ID為空時，該參數(shù)不允許為空。設備ID、產(chǎn)品的Key和設備名稱若同時填寫，以設備ID為準。

返回數(shù)據(jù)

名稱 類型 示例值 描述
code Int

接口返回碼。200表示成功。
message String

調(diào)用失敗時，返回的出錯信息。
localizedMsg String

本地語言的錯誤消息。

示例

請求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.0",
		"iotToken": "token"
	},
	"params":{
		"devices":[
			{
				"iotId": "7bvbyRItBXQxxxxxxQt9X00109ea700"
			},
			{
				"iotId": "7bvbyRItBXQxxxxxxQt9X00109ea711"
			}
		]
	}
}

正常返回示例

JSON 格式 

{
    "id": "4de2c367-c1db-417c-aa15-8c585e595d92",
    "code": 200,
    "message": null,
    "localizedMsg": null
}

異常返回示例

JSON 格式 

{
    "id": "37f7e5fa-d6a5-4efe-8abf-5bf23dca6284",
    "code": 403,
    "message": "request forbidden.",
    "localizedMsg": "請求被禁止",
    "data": null
}