调用该接口设置物的属性。

路径 /thing/properties/set
版本号 1.0.5
协议 HTTP,HTTPS
请求方法 POST
是否需要用户身份鉴权
超时时间 3000

请求参数

名称 类型 是否必选 示例值 描述
iotId String aD12ef8Kk****EiNJJ001082 设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。该字段与ProductKey+DeviceName 的组合必须至少填写一个。
items Struct {"powerstate":0} Set参数。
userId String 账户ID。
userType String TAOBAO 账户类型:“TAOBAO”、“ALIPAY”。
origin String TmallGenie 调用来源。
productKey String a1U2****UZI 产品的Key,设备证书信息之一。创建产品时,生活物联网平台为该产品颁发的全局唯一标识。
deviceName String light001 设备的名称,设备证书信息之一。在注册设备时,自定义的或系统生成的设备名称,具备产品维度内的唯一性。该字段存在时ProductKey必填。

返回数据

名称 类型 示例值 描述
code Int

接口返回码。200表示成功。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.5",
		"iotToken": "token"
	},
	"params":{
		"iotId": "aD12ef8Kk****EiNJJ001082",
		"items":{
			"powerstate":0
		},
		"userId": "value2",
		"userType": "TAOBAO",
		"origin": "TmallGenie",
		"productKey": "a1U2****UZI",
		"deviceName": "light001"
	}
}

正常返回示例

JSON格式

{
  "code": 200,
  "data": null,
  "message": "success",
  "localizedMsg": ""
}

异常返回示例

JSON格式

{}