查询设备某天的云录像文件统计

按设备和设备本地日期，统计云录像索引与 OSS 录像文件是否一致。支持普通录像切片和 AOV 长切片。

鉴权与授权

用于开发者服务器调用，沿用 API For Server 的 TGV1-HMAC-SHA256 签名机制。

签名凭证属于 App；接口同时校验设备所属产品是否归属于该 App 对应的 Customer。无权访问其他 Customer 的设备。

GET 请求不含 Body，签名 Header 与同目录其他 GET 接口保持一致。

查询范围

date 按设备配置的时区解释。历史日期查询完整自然日；查询设备当天时，结束时间为服务器当前时间。

不允许查询未来日期。

返回完整日期范围的统计，不要求调用方按小时拆分。

统计口径

file_missing：录像索引中记录了文件，但 OSS 中找不到对应文件。

index_missing：OSS 中存在录像文件，但录像索引中没有对应记录。

items 只包含异常，并将同一 loss_type、同一 ossid、时间连续的文件合并为一个时间段。

常见错误

400 / bad_param：设备 ID 或日期格式不正确，或查询未来日期。

400 / 16280032：设备所属产品不属于当前 App 对应的 Customer。

400 / 15090035 / cannot_determine_video_oss：无法从录像索引确定 OSS；查询当天且没有索引时也无法从当前绑定确定 OSS。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

查询成功。

Bodyapplication/json

示例

示例同时展示 AOV 长切片对应的 file_missing，以及 OSS 文件存在但索引缺失的 index_missing。

{
  "code": 200,
  "data": {
    "summary": {
      "index_file_quantity": 2,
      "oss_file_quantity": 2,
      "file_found_quantity": 1,
      "file_missing_quantity": 1,
      "index_missing_quantity": 1
    },
    "total": 2,
    "items": [
      {
        "loss_type": "file_missing",
        "start_time": 1774576095,
        "end_time": 1774576408,
        "ossid": "195",
        "file_quantity": 1,
        "files": [
          "1702D8OBYWWQ/2026/03/27/09/48-15-313.data"
        ]
      },
      {
        "loss_type": "index_missing",
        "start_time": 1774577100,
        "end_time": 1774577110,
        "ossid": "195",
        "file_quantity": 1,
        "files": [
          "1702D8OBYWWQ/2026/03/27/10/05-00-10.data"
        ]
      }
    ]
  },
  "msg": "ok",
  "ok": 1,
  "requestid": "01JXAMPLE000000000000000000",
  "status": "ok"
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

鉴权与授权#

查询范围#

统计口径#