执行设备服务

此接口用于执行设备下行服务。

1 接口路径

POST /api/v1/device/invoke/thing/service

2 请求参数

body参数,json格式:

名称 类型 是否必需 描述
deviceId BigInteger 设备ID
productKey String 产品唯一标识
serviceKey String 设备模型中定义的服务标识
params json 服务标识符的入参信息,设备模型中定义
liveTime Integer 消息缓存时长(单位秒),【下行异步】服务时必填,0为不缓存,最大值8640000(100天),默认值604800(7天)
version String 协议版本,保留字段

3 返回参数

统一返回参数说明参考:公共参数,正常的返回业务参数(data)为null

4 返回状态码

公共状态码说明参考:公共参数,以下是业务关联的状态码说明:

code 描述
120106 设备不存在或没有权限
120112 功能标识符未定义
120119 设备不在线
150502 无活动连接

5 示例

请求示例

{
  "deviceId": 297160167601094656,
  "serviceKey": "service_down_async",
  "params": {
  	"color":123
  },
  "productKey": "1_783dcb3cf4d"
}

返回示例

{
    "code": "150502",
    "data": null,
    "message": "无活动连接"
}