云服务 API 参考行业场景垂直行业解决方案智慧巡店智慧巡店获取已关联的巡店设备上报的巡店事件列表

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

更新时间：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
}

错误码

参考错误码。