执行设备服务
此接口用于执行设备下行服务。
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": "无活动连接"
}