调用该接口触发物的服务。

路径 /cloud/thing/service/invoke
版本号 1.0.2
协议 HTTPS
请求方法 POST
是否需要用户身份鉴权
超时时间 15000

请求参数

名称 类型 是否必选 示例值 描述
iotId String xxxxxxxx 设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。productKey和deviceName为空时,该入参不允许为空。
identifier String xxxxxxxx 服务的标识符。
args JSON {} 服务入参。
productKey String 产品的Key,设备证书信息之一。创建产品时,生活物联网平台为该产品颁发的全局唯一标识。当iotId为空时,该参数不允许为空。
deviceName String 设备的名称,设备证书信息之一。在注册设备时,自定义的或系统生成的设备名称,具备产品维度内的唯一性。当iotId为空时,该参数不允许为空。

返回数据

名称 类型 示例值 描述
data JSON

调用返回结果。该返回值类型及值取决于设备端的实现逻辑。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.2"
	},
	"params":{
		"iotId": "xxxxxxxx",
		"identifier": "xxxxxxxx",
		"args":{},
		"productKey": "value3",
		"deviceName": "value4"
	}
}

正常返回示例

JSON 格式

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

异常返回示例

JSON 格式

{}