调用该接口触发物的服务,包括同步服务和异步服务。

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

请求参数

名称 类型 是否必选 示例值 描述
iotId String deviceAbc 设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。
identifier String propId 服务标识符。
args Struct {"tslPropId":"tslPropVal"} 服务入参,请参考TSL模型。
origin String TmallGenie 调用来源,默认不传。
userType String TAOBAO 账号类型,默认不用传。
userId String 234567 账号ID,默认不传。

返回数据

名称 类型 示例值 描述
data String

该返回值类型及值取决于设备端实现逻辑。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.5",
		"iotToken": "token"
	},
	"params":{
		"iotId": "deviceAbc",
		"identifier": "propId",
		"args":{
			"tslPropId": "tslPropVal"
		},
		"origin": "TmallGenie",
		"userType": "TAOBAO",
		"userId": "234567"
	}
}

正常返回示例

JSON 格式

{
    "id": "b99e4d58-019e-4d3a-96c1-d978ccb6****",
    "code": 200,
    "message": null,
    "localizedMsg": null,
    "data":{
        "data":{
          "name":"abc",
          "age":12
        },
        "messageId":1987572
    }
}

异常返回示例

JSON 格式

{
    "id": "166267b9-c15e-4180-8cf5-0081f655****",
    "code": 29004,
    "message": "device is unbind",
    "localizedMsg": "device is unbind",
    "data": null
}