You need to enable JavaScript to run this app.
文档中心
文档控制台
注册
智能视联

智能视联

复制全文
下载 pdf
云眸协议
ListHikCloudStoreStatistics - 门店统计列表
复制全文
下载 pdf
ListHikCloudStoreStatistics - 门店统计列表

设备报表页表格主体,按门店维度分页返回设备/摄像头统计,支持按区域/门店/关键字过滤

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

参数
类型
是否必填
示例值
描述
Action
String

ListHikCloudStoreStatistics

要执行的操作,取值:ListHikCloudStoreStatistics。

Version
String

2026-07-01

API的版本,取值:2026-07-01。

SpaceID
String

8b629168-70bf-42be-ae15-7d259006bd9e

空间 ID

AreaID
String

1001

区域 ID(含子区域下所有门店)

StoreID
String

S001

门店ID

Keyword
String

朝阳

按门店名称关键字检索

PageNumber
Integer

1

页码,默认 1

PageSize
Integer

20

每页条数,默认 20,最大 200

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数
类型
示例值
描述
Total
Integer

1

总数

PageNumber
Integer

1

当前页码

PageSize
Integer

20

每页条数

Stores
Array of Object

[
{
"StoreID": "storeid",
"StoreNo": "storeno",
"StoreName": "门店",
"AreaID": "abc",
"Device": {
"Total": 10,
"Online": 9,
"Offline": 1,
"OnlineRate": 90
},
"Camera": {
"Total": 20,
"Online": 19,
"Offline": 1,
"Unknown": 0,
"OnlineRate": 95
}
}
]

门店统计列表

请求示例

GET /?Action=ListHikCloudStoreStatistics&Version=2026-07-01&SpaceID=8b629168-70bf-42be-ae15-7d259006bd9e&AreaID=1001&StoreID=S001&Keyword=朝阳&PageNumber=1&PageSize=20 HTTP/1.1
Host: open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20260711T120000Z
X-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Authorization: HMAC-SHA256 Credential=AKLT********/20260711/cn-beijing/aiotvideo/request, SignedHeaders=host;x-content-sha256;x-date, Signature=****************************************

返回示例

{
  "ResponseMetadata": {
    "RequestId": "2026071120000000000000000000000000",
    "Action": "ListHikCloudStoreStatistics",
    "Version": "2026-07-01",
    "Service": "aiotvideo",
    "Region": "cn-beijing",
    "Error": null
  },
  "Result": {
    "Total": 100,
    "PageNumber": 1,
    "PageSize": 20,
    "Stores": [
      {
        "StoreID": "storeid",
        "StoreNo": "storeno",
        "StoreName": "门店",
        "AreaID": "abc",
        "Device": {
          "Total": 10,
          "Online": 9,
          "Offline": 1,
          "OnlineRate": 90
        },
        "Camera": {
          "Total": 20,
          "Online": 19,
          "Offline": 1,
          "Unknown": 0,
          "OnlineRate": 95
        }
      }
    ]
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
401
hik_credential_invalid

Invalid HikCloud credential

ClientID/ClientSecret 无效或 token 获取失败

401
credential_invalid

Credential expired or invalid

鉴权信息已失效,请重新验证凭证

403
forbidden

Access denied

空间不属于当前 AccountID

403
hik_no_permission

No permission

无数据操作权限

500
hik_cloud_not_configured

HikCloud service not configured

服务未配置 master_key 或 TOS

最近更新时间:2026.07.24 15:47:12
这个页面对您有帮助吗?
有用
有用
无用
无用