获取已关联的巡店设备上报的巡店事件列表

更新时间：2023-06-21 07:13:03下载pdf

本文介绍获取已关联的巡店设备上报的巡店事件列表的 API。

接口描述

获取资产下已关联的巡店设备上报的巡店事件列表。最大查询时间范围为过去 31 天的巡店事件。

接口地址

GET: /v1.0/iot-03/store-inspection/assets/{asset_id}/events

请求参数

参数名	类型	参数位置	是否必填	说明
asset_id	String	uri	true	资产 ID。
device_ids	String	query	false	设备 ID 列表，多个设备 ID 用半角逗号,分隔。最多 20 个设备 ID，分页情况下是逐个展示设备的事件。
event_types	String	query	false	巡店事件类型列表，多个事件类型用半角逗号,分隔。 ai_no_helmet：未戴安全帽 ai_no_suit：未穿工服 ai_enter_area：区域入侵 ai_sleep：睡岗检测 ai_chanl_block：通道阻塞 ai_calling：打电话检测 ai_smoking：吸烟检测
start_time	Long	query	false	开始时间 13 位时间戳，异常事件时间范围开始点。存在end_time时必需存在且小于end_time，不传默认查询至今 31 天的范围。
end_time	Long	query	false	结束时间 13 位时间戳，异常事件事件范围结束点。存在start_time时必需存在且大于start_time,不传默认查询至今 31 天的范围。
page_size	Integer	query	false	页大小，默认 20。必须是正整数，最大 100。
page_no	Integer	query	false	页码，默认 1。必须是正整数。

返回参数

参数名	类型	说明
result	Page

result 说明

参数名	类型	说明
total	Long	符合条件的数据总数。
list	List	巡店事件列表。
has_more	Boolean	是否有下一页，true：有，false：没有。

list 说明

参数名	类型	说明
name	String	巡店事件名称。
event_time	Long	巡店事件发生时间，13 位时间戳。
event_type	String	巡店事件类型。 ai_no_helmet：未戴安全帽 ai_no_suit：未穿工服 ai_enter_area：区域入侵 ai_sleep：睡岗检测 ai_chanl_block：通道阻塞 ai_calling：打电话检测 ai_smoking：吸烟检测
device_id	String	巡店设备 ID。
device_name	String	巡店设备名称。
event_id	String	巡店事件 ID。
files	List	巡店事件携带的文件列表。

files 说明

参数名	类型	说明
file_desc	String	文件的描述。
image_url	String	事件文件可访问的预签名 URL，有效期 2 小时。

请求示例

GET: /v1.0/iot-03/store-inspection/assets/142310607698275****/events?device_ids=6cf46c2ba4e7b25536****,vdevo16284993087****

返回示例

{
    "result": {
        "list": [
            {
                "device_id": "6cf46c2ba4e7b25536****",
                "device_name": "双光源球机-SC084-WN04-400W-内测",
                "event_id": "446186****",
                "event_type": "ai_enter_area",
                "name": "ai_enter_area",
                "files": [
                    {
                        "image_url": "https://ty-cn-storage30-1254153901.cos.ap-shanghai.myqcloud.com/3a1f04-38505253-a1b2f8a7c1845059/unify/1628579799.jpeg?sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDopcCYgw0qRoyV5qfKjvg2pPkqESnb5zI%26q-sign-time%3D1628587878%3B1628595078%26q-key-time%3D1628587878%3B1628595078%26q-header-list%3Dhost%26q-url-param-list%3D%26q-signature%3Dbfd91dfd4c93a49d20daff931e025aa3d632****",
                        "file_desc": "bigImage"
                    },
                    {
                        "image_url": "https://ty-cn-storage30-1254153901.cos.ap-shanghai.myqcloud.com/3a1f04-38505253-a1b2f8a7c1845059/unify/1628579799.jpeg?sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDopcCYgw0qRoyV5qfKjvg2pPkqESnb5zI%26q-sign-time%3D1628587878%3B1628595078%26q-key-time%3D1628587878%3B1628595078%26q-header-list%3Dhost%26q-url-param-list%3D%26q-signature%3Dbfd91dfd4c93a49d20daff931e025aa3d632****",
                        "file_desc": "smallImage"
                    }
                ],
                "event_time": 1628580350000
            },
            {
                "device_id": "6cf46c2ba4e7b25536****",
                "device_name": "双光源球机-SC084-WN04-400W-内测",
                "event_id": "446183****",
                "event_type": "ai_enter_area",
                "name": "ai_enter_area",
                "files": [
                    {
                        "image_url": "https://ty-cn-storage30-1254153901.cos.ap-shanghai.myqcloud.com/3a1f04-38505253-a1b2f8a7c1845059/unify/1628568170.jpeg?sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDopcCYgw0qRoyV5qfKjvg2pPkqESnb5zI%26q-sign-time%3D1628587878%3B1628595078%26q-key-time%3D1628587878%3B1628595078%26q-header-list%3Dhost%26q-url-param-list%3D%26q-signature%3Dccafd56e45904bd50d3aa93b401b1e6e8a97****",
                        "file_desc": "bigImage"
                    },
                    {
                        "image_url": "https://ty-cn-storage30-1254153901.cos.ap-shanghai.myqcloud.com/3a1f04-38505253-a1b2f8a7c1845059/unify/1628568170.jpeg?sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDopcCYgw0qRoyV5qfKjvg2pPkqESnb5zI%26q-sign-time%3D1628587878%3B1628595078%26q-key-time%3D1628587878%3B1628595078%26q-header-list%3Dhost%26q-url-param-list%3D%26q-signature%3Dccafd56e45904bd50d3aa93b401b1e6e8a97****",
                        "file_desc": "smallImage"
                    }
                ],
                "event_time": 1628571312000
            },
            {
                "device_id": "6cf46c2ba4e7b25536****",
                "device_name": "双光源球机-SC084-WN04-400W-内测",
                "event_id": "446182****",
                "event_type": "ai_enter_area",
                "name": "ai_enter_area",
                "files": [
                    {
                        "image_url": "https://ty-cn-storage30-1254153901.cos.ap-shanghai.myqcloud.com/3a1f04-38505253-a1b2f8a7c1845059/unify/1628565175.jpeg?sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDopcCYgw0qRoyV5qfKjvg2pPkqESnb5zI%26q-sign-time%3D1628587878%3B1628595078%26q-key-time%3D1628587878%3B1628595078%26q-header-list%3Dhost%26q-url-param-list%3D%26q-signature%3D26dcb7cedb6efb97dce68c34e7694b73b088****",
                        "file_desc": "bigImage"
                    },
                    {
                        "image_url": "https://ty-cn-storage30-1254153901.cos.ap-shanghai.myqcloud.com/3a1f04-38505253-a1b2f8a7c1845059/unify/1628565175.jpeg?sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDopcCYgw0qRoyV5qfKjvg2pPkqESnb5zI%26q-sign-time%3D1628587878%3B1628595078%26q-key-time%3D1628587878%3B1628595078%26q-header-list%3Dhost%26q-url-param-list%3D%26q-signature%3D26dcb7cedb6efb97dce68c34e7694b73b088****",
                        "file_desc": "smallImage"
                    }
                ],
                "event_time": 1628566274000
            },
            {
                "device_id": "vdevo16284993087****",
                "device_name": "智能摄像机-vdevo",
                "event_id": "446164****",
                "event_type": "ai_no_suit",
                "name": "ai_no_suit",
                "files": [
                    {
                        "image_url": "https://airtake-private-data-1254153901.cos.ap-shanghai.myqcloud.com/groot-test-tuya/image/21a3c1cefff5df476e8c4609e8d330e1.jpeg?sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDopcCYgw0qRoyV5qfKjvg2pPkqESnb5zI%26q-sign-time%3D1628587878%3B1628595078%26q-key-time%3D1628587878%3B1628595078%26q-header-list%3Dhost%26q-url-param-list%3D%26q-signature%3D9fb2a1457017473d2c1fe04e0ccbf4926edd****",
                        "file_desc": "bigImage"
                    },
                    {
                        "image_url": "https://airtake-private-data-1254153901.cos.ap-shanghai.myqcloud.com/groot-test-tuya/image/21a3c1cefff5df476e8c4609e8d330e1.jpeg?sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDopcCYgw0qRoyV5qfKjvg2pPkqESnb5zI%26q-sign-time%3D1628587878%3B1628595078%26q-key-time%3D1628587878%3B1628595078%26q-header-list%3Dhost%26q-url-param-list%3D%26q-signature%3D9fb2a1457017473d2c1fe04e0ccbf4926edd****",
                        "file_desc": "smallImage"
                    }
                ],
                "event_time": 1628499988000
            }
        ],
        "total": 4,
        "has_more": false
    },
    "t": 1628587878504,
    "success": true
}

错误码

参考错误码。