1. 接口描述

接口请求域名: vssapi.ctyun.cn
默认接口请求频率限制：500次/秒。

对绑定AI算法的设备查询AI对应的分析结果。

2. 请求参数

参数	类型	是否必选	示例值	描述
Action	String	是	DescribeAiResultList	操作接口名，系统规定参数。
AppId	Long	否	32388487739092996	AI appID。
DeviceId	Long	否	32388487739092996	设备ID。设备ID传参，必须带上接入协议参数 InProtocol
InProtocol	String	否	gb28181	使用的接入协议。取值: ehome。
ConfidenceMin	Float	否	0	最小置信度
ConfidenceMax	Float	否	100	最大置信度
StartTime	Long	否	1638892800	开始时间
EndTime	Long	否	1638979199	结束时间
AlgorithmMetadata	String	否	CreatedTime	算法返回的告警展示信息
SortBy	String	否	UpdatedTime	根据字段排序： 1）UpdatedTime：根据更新时间排序 2）若不选择则根据创建时间排序
SortDirection	String	否	desc	整体结果排序： 1）默认正序排序 2）选择desc则倒序排序
PageNum	Long	否	1	页数:默认第一页
PageSize	Long	否	20	页面大小：默认页面大小20条数据
TimeInterval	Long	否	1	时间间隔
ResultTimeInterval	Long	否	1	间隔频率

3. 返回参数

参数	类型	描述
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
ScreenShotList	ScreenShot[]	AI返回结果
PageNum	Long	第几个分页。
PageSize	Long	分页大小。
TotalPage	Long	分页总数。
TotalNum	Long	模板总数。

ScreenShot

参数	类型	描述
Time	Long	截图时间 Unix时间戳，精确到秒。
DeviceName	String	设备名称。
Confidence	Float	置信度。
Image	String	图片地址。
Metadata	String	算法配置数据
ImageThumbnail	String	图片缩略图地址。
ChannelName	String	通道名称。
DeviceId	Long	设备Id。
AppId	Long	应用Id。
AppName	String	应用名字。
AlgorithmsId	Long	算法Id。

4. 示例

4.1 请求示例

https://vssapi.ctyun.cn/?
AccessKeyId=JG2X245XD5R3NK2U****
&Action=DescribeAiResultList
&AppId=34
&DeviceId=345208597731377154
&InProtocol=ehome
&PageSize=2
&Signature=x6nL98u6M915oF%2FpEwukpQMWX4o%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=1599506569
&SignatureVersion=1.0
&Timestamp=1639536940
&Version=2020-06-12

4.2 返回示例

{
  "ScreenShotList": [
    {
      "Time": "2021-12-15 09:16:10",
      "DeviceName": "EHOME51NVR",
      "Confidence": 0.91,
      "Image": "https://127.0.0.1:1234/vss-resource01_video_wgw1-1/345208597731377154/ai/2021-12-15/20211215-091608-d50835a4-836f-46bc-9e5c-fe21650b0b7c.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=QK3UOU50KUN39XM4L3E1%2F20211215%2Fdefault%2Fs3%2Faws4_request&X-Amz-Date=20211215T025551Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&X-Amz-Signature=cb6e5549c71f8e53b2fd90dcc451e118db8f45245dd03e0237258892f6474a77",
      "ImageThumbnail": "http://127.0.0.1:9080/vss/thumb/200x0/guiyang.vcn.ctyun.cn%2Fvss-resource01_video_wgw1-1%2F345208597731377154%2Fai%2F2021-12-15%2F20211215-091608-d50835a4-836f-46bc-9e5c-fe21650b0b7c.jpg%3FX-Amz-Algorithm%3DAWS4-HMAC-SHA256%26X-Amz-Credential%3DQK3UOU50KUN39XM4L3E1%252F20211215%252Fdefault%252Fs3%252Faws4_request%26X-Amz-Date%3D20211215T025551Z%26X-Amz-Expires%3D86400%26X-Amz-SignedHeaders%3Dhost%26X-Amz-Signature%3Dcb6e5549c71f8e53b2fd90dcc451e118db8f45245dd03e0237258892f6474a77",
      "ChannelName": "IPdome",
      "DeviceId": "345208597731377154",
      "AppId": "34",
      "AppName": "人体属性检测人体属性",
      "AlgorithmsId": "9"
    },
    {
      "Time": "2021-12-15 09:16:09",
      "DeviceName": "EHOME51NVR",
      "Confidence": 0.87,
      "Image": "https://127.0.0.1:1234/vss-resource01_video_wgw1-1/345208597731377154/ai/2021-12-15/20211215-091607-172b8506-5ec1-40b4-a268-9cf7325220a2.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=QK3UOU50KUN39XM4L3E1%2F20211215%2Fdefault%2Fs3%2Faws4_request&X-Amz-Date=20211215T025551Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&X-Amz-Signature=f3501499e3731e9947eaae9af9cc3b6334f16ef1de7d1a2c7ae7b29552a1b5bb",
      "ImageThumbnail": "http://127.0.0.1:9080/vss/thumb/200x0/guiyang.vcn.ctyun.cn%2Fvss-resource01_video_wgw1-1%2F345208597731377154%2Fai%2F2021-12-15%2F20211215-091607-172b8506-5ec1-40b4-a268-9cf7325220a2.jpg%3FX-Amz-Algorithm%3DAWS4-HMAC-SHA256%26X-Amz-Credential%3DQK3UOU50KUN39XM4L3E1%252F20211215%252Fdefault%252Fs3%252Faws4_request%26X-Amz-Date%3D20211215T025551Z%26X-Amz-Expires%3D86400%26X-Amz-SignedHeaders%3Dhost%26X-Amz-Signature%3Df3501499e3731e9947eaae9af9cc3b6334f16ef1de7d1a2c7ae7b29552a1b5bb",
      "ChannelName": "IPdome",
      "DeviceId": "345208597731377154",
      "AppId": "34",
      "AppName": "人体属性检测人体属性",
      "AlgorithmsId": "9"
    }
  ],
  "RequestId": "68ed32a014754d9b89594cd94fec9e75",
  "PageNum": 1,
  "PageSize": 2,
  "TotalPage": 1372,
  "TotalNum": 2744
}

5. 错误码

ErrorCode	ErrorMessage

AI分析结果告警查询

最近更新时间：2025-02-21 02:50:53

1. 接口描述

2. 请求参数

3. 返回参数

4. 示例

4.1 请求示例

4.2 返回示例

5. 错误码