移動家下設備的順序。

路徑 /living/home/device/reorder
版本號 1.0.0
協議 HTTPS
請求方法 POST
是否需要用戶身份鑒權 是
超時時間 5000

請求參數

名稱 類型 是否必選 示例值 描述
homeId String 是 50f5op1556f65de****983fd5bca4f2f28104512 家的 ID，生活物聯網平臺賦予家的唯一標識符。
iotId String 否 edwB6TqvOW****mY7TNa000100 設備的 iotId。 如果 productKey 和 deviceName 字段為空，該字段必填。 如果 iotId，productKey 和 deviceName 都不為空，以 iotId 作為設備的唯一標識。
productKey String 否 a1UU****vsk 設備所屬產品的產品Key。 如果iotId字段為空，該字段必填。
deviceName String 否 deviceName 設備的名稱。 如果 iotId 字段為空，該字段必填。
targetOrder Int 是 7 設備的目標位置，從 0 開始。

返回數據

名稱 類型 示例值 描述
code Int

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

調用失敗時，返回的出錯信息。
localizedMsg String

本地語言的錯誤信息。

示例

請求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.0",
		"iotToken": "token"
	},
	"params":{
		"homeId": "50f5op1556f65de****983fd5bca4f2f28104512",
		"iotId": "edwB6TqvOW****mY7TNa000100",
		"productKey": "a1UU****vsk",
		"deviceName": "deviceName",
		"targetOrder":7
	}
}

正常返回示例

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": "請求被禁止"
}