设备事件上报

更新时间：2023-06-15 05:35:07

本文介绍设备事件上报的 API。

接口描述

设备事件上报，是指设备上报的瞬时通知消息。消息可以包含多个输出参数，需要被外部感知和处理。

接口地址

POST: /v1.0/iot-03/3rdcloud/devices/{device_id}/event/report

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	uri	true	涂鸦设备 ID。

body 说明

参数名	类型	参数位置	是否必填	说明
msg_id	String	body	true	本次请求的唯⼀标识，⻓度不超过 32 个字符。
data	Object	body	true	事件输出参数。

data 说明

参数名	类型	参数位置	是否必填	说明
event_code	String	body	true	事件 code，功能标识符。
event_time	Long	body	true	事件发⽣时间，13 位标准时间戳。
output_params	Object	body	false	事件输出参数。

返回参数

参数名	类型	说明
result	Boolean	响应结果。
code	String	参见错误码，成功为空。
msg	String	请求失败的信息，成功为空。
success	Boolean	请求是否成功。 `true`：成功 `false`：失败
t	Long	请求响应的时间戳，长度 13 位。

请求示例

POST: /v1.0/iot-03/3rdcloud/devices/6cf4171005d11e2ca7****/event/report

{
  "msg_id": "ed23rty159292****",
  "data": {
    "event_code": "read_face",
    "event_time": 1592920221212,
    "output_params": {
      "sex": "man",
      "age": 23
    }
  }
}

返回示例

{
    "result": true,
    "t": 1650010133685,
    "success": true
}

错误码

参考错误码。