查询设备整月云录像日历

按设备时区查询一个完整自然月，供 App 日历标记哪些日期有云录像。

month 必须为 YYYY-MM，例如 2026-11。无需传起止日期或时区。

返回当月全部日期，按日期升序排列；无录像日期也返回，has_recording=false。

时区使用设备配置解析后的 IANA 时区，并在 data.timezone 返回；自然日边界按该时区计算，支持夏令时。

has_recording 表示该日期存在当前用户可见的有效录像索引，按整台设备判断。

沿用设备绑定、换主时间、录像保存期和逻辑删除规则；日历不额外设置历史查询期限。

参数、鉴权或依赖查询失败时返回错误，不返回部分月份。

调试前在所选环境或本地变量中填写 app_id、device_id、token。token 使用该设备绑定用户的 access_token 或用户 API Key；鉴权页配置为 Bearer Token。请求头使用样例中的平台、语言和 SDK 数字版本。

响应示例包含完整 30 天的有/无录像月份、29 天空月、月份参数错误和未登录。调试用例中的空月示例仍按设备当前保存期与可见性规则返回结果。

需求：7166852449。已在 cloud-test 验证，正式环境请以服务发布情况为准。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

成功：完整自然月（含有录像和无录像日期）成功：历史空月（闰年 29 天）

{
  "code": 200,
  "msg": "ok",
  "ok": 1,
  "status": "ok",
  "requestid": "",
  "data": {
    "month": "2026-11",
    "timezone": "Europe/Paris",
    "items": [
      {
        "date": "2026-11-01",
        "has_recording": false
      },
      {
        "date": "2026-11-02",
        "has_recording": false
      },
      {
        "date": "2026-11-03",
        "has_recording": false
      },
      {
        "date": "2026-11-04",
        "has_recording": false
      },
      {
        "date": "2026-11-05",
        "has_recording": false
      },
      {
        "date": "2026-11-06",
        "has_recording": true
      },
      {
        "date": "2026-11-07",
        "has_recording": true
      },
      {
        "date": "2026-11-08",
        "has_recording": true
      },
      {
        "date": "2026-11-09",
        "has_recording": true
      },
      {
        "date": "2026-11-10",
        "has_recording": true
      },
      {
        "date": "2026-11-11",
        "has_recording": true
      },
      {
        "date": "2026-11-12",
        "has_recording": true
      },
      {
        "date": "2026-11-13",
        "has_recording": false
      },
      {
        "date": "2026-11-14",
        "has_recording": false
      },
      {
        "date": "2026-11-15",
        "has_recording": false
      },
      {
        "date": "2026-11-16",
        "has_recording": false
      },
      {
        "date": "2026-11-17",
        "has_recording": false
      },
      {
        "date": "2026-11-18",
        "has_recording": false
      },
      {
        "date": "2026-11-19",
        "has_recording": false
      },
      {
        "date": "2026-11-20",
        "has_recording": false
      },
      {
        "date": "2026-11-21",
        "has_recording": false
      },
      {
        "date": "2026-11-22",
        "has_recording": false
      },
      {
        "date": "2026-11-23",
        "has_recording": false
      },
      {
        "date": "2026-11-24",
        "has_recording": false
      },
      {
        "date": "2026-11-25",
        "has_recording": false
      },
      {
        "date": "2026-11-26",
        "has_recording": false
      },
      {
        "date": "2026-11-27",
        "has_recording": false
      },
      {
        "date": "2026-11-28",
        "has_recording": false
      },
      {
        "date": "2026-11-29",
        "has_recording": false
      },
      {
        "date": "2026-11-30",
        "has_recording": false
      }
    ]
  }
}

🟠400参数、设备权限或查询失败

🟠401未登录或登录凭据无效

请求参数

请求示例代码

返回响应