开始使用
  • English
  • 简体中文
前往官网
开始使用
  • English
  • 简体中文
前往官网
  • 开始使用
  • 核心概念
  • 开发指南
  • 设备能力与事件参考
  • API 参考
    • 公共约定
    • HTTP 开发规范
    • accessToken(管理员 Token)
    • API 请求示例
    • 错误码
    • 接口调用限额
    • 账号与授权
    • 设备接口
    • 直播地址
    • 推送配置
    • 云存储
    • 资源池额度管理
    • 旧版接口(不再维护)
      • 门锁(遗留)
      • 告警消息(遗留)
      • 设备查询(已弃用)
      • 设备维护(遗留)
      • 设备操作(遗留)
      • 设备使能(遗留)
        • breathingLightStatus(获取呼吸灯状态)
        • getDeviceCameraStatus(获取设备使能开关状态)
        • modifyBreathingLight(设置呼吸灯开关)
        • setDeviceCameraStatus(设置设备使能开关)
      • 动检配置(遗留)
      • 收藏点(遗留)
      • 定时巡航(遗留)
      • 本地录像配置(遗留)
      • 音量(遗留)
      • 存储(遗留)
      • 图像与视频(遗留)
      • 时区(遗留)
      • Wi-Fi(遗留)
      • 本地录像查询(遗留)
  • SDK 与工具
  • 方案
  • 平台与支持
本页目录
请求格式
功能说明
请求地址
请求参数
请求示例
返回 data 字段
响应示例
错误码
说明
说明
相关
相关参考

modifyBreathingLight(设置呼吸灯开关)

modifyBreathingLight:设置呼吸灯开关

请求格式

POST JSON 请求体见 请求约定;签名见 签名。

遗留 HTTP 保留: 新接入可使用 设备指示灯(light.indicator.enabled)对应能力。两套接口不是一对一替代。 registry 只登记了 breathingLightStatus,未登记本方法。

功能说明

设置设备呼吸灯开/关。

请求地址

https://openapi-[DataCenter].easy4ip.com/openapi/modifyBreathingLight

请求参数

参数名参数类型是否必填默认值合法值参数说明
tokenString是管理员accessToken
deviceIdString是设备序列号
statusString是on:开启,off:关闭状态

请求示例

{
 "system":{
 "ver":"1.0",
 "appId":"lcdxxxxxxxxx",
 "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
 "time":1603353173,
 "nonce":"f625ddf1-f7fd-4be6-a095-75958464f694"
 },
 "id":"1278d520-ed24-46ba-bb4f-daa3dcbf766f",
 "params":{
 "deviceId":"TESTQWERXXXX",
 "status":"on",
 "token": "<yourAccessToken>"
 }
}

返回 data 字段

无data数据返回

响应示例

{
 "result":{
 "msg":"操作成功。",
 "code":"0"
 },
 "id":"1278d520-ed24-46ba-bb4f-daa3dcbf766f"
}

错误码

本接口可能返回下列码;完整分组见 错误码 与 能力错误码。

说明

支持管理员或子账号 accessToken。子账号须在策略中授予对应设备/通道权限,配置见 权限码。 本接口属于旧版协议,无替代。

网关与鉴权(SN / TK / OP)

错误码错误码说明下一步
SN1001签名校验异常按 HTTP 开发规范 核对 sign
TK1002token 无效或过期重新获取 accessToken
OP1002缺少必填参数补必填字段
OP1003参数不合法按本页参数表核对
OP1009权限不足核对 token 与设备绑定/分享权限
OP1013接口总次数超限降低调用频率
OP1014接口日限额超限见 接口调用限额
DV1007设备离线等设备上线

更多见 错误码 · OP/SN/TK。

子账号(SUB)

错误码错误码说明下一步
SUB1001–SUB1002子账号无接口权限在 addPolicy 中补策略
SUB1005子账号 token 过期重新 subAccountToken
SUB1006子账号与设备无授权核对 Resource 与设备序列号
SUB1008子账号未绑定应用先创建并绑定子账号

更多见 错误码 · SUB。

设备访问与通道(DV10xx)

错误码错误码说明下一步
DV1007设备离线或超时等设备上线
DV1009设备正忙稍后重试
DV1012分享/授权设备权限不足核对子账号 Permission / Resource
DV1019能力集不支持确认型号与能力列表
DV1020通道离线检查通道状态
DV1026不支持此功能换接口或升级固件
DV1028未绑定或通道不存在核对 deviceId / channelId

更多见 错误码 · DV。

说明

支持管理员或子账号 accessToken。子账号须在策略中授予对应设备/通道权限,配置见 权限码。

本接口属于旧版协议,无替代。

相关

  • 旧版协议目录

相关参考

  • 开发规范
  • 公共约定
  • 本模块索引
getDeviceCameraStatus(获取设备使能开关状态)
setDeviceCameraStatus(设置设备使能开关)