接口列表

本节包含A1系列等告警主机设备关联的探测器的操作相关接口等。

接口列表如下：

获取探测器列表

• 接口功能

  该接口用于获取设备下关联的探测器列表（需要设备支持关联探测器）

• 请求地址

  https://open.ys7.com/api/lapp/detector/list

• 请求方式

  POST

• 子账户token请求所需最小权限

  "Permission":"Get" "Resource":"dev:序列号"

• 请求参数

• HTTP请求报文

POST /api/lapp/detector/list HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.9mqitppidgce4y8n54ranvyqc9fjtsrl&deviceSerial=596510888

• 返回数据

{
     "result": {
         "data": [
             {
                 "detectorSerial": "594012222",
                 "detectorType": "callhelp",
                 "detectorState": 1,
                 "detectorTypeName": "紧急按钮",
                 "location": "紧急按钮",
                 "zfStatus": 0,
                 "uvStatus": 0,
                 "iwcStatus": 0,
                 "olStatus": 0,
                 "atHomeEnable": 1,
                 "outerEnable": 1,
                 "sleepEnable": 1
             },
             {
                 "detectorSerial": "303333333",
                 "detectorType": "waterlogging",
                 "detectorState": 1,
                 "detectorTypeName": "水浸",
                 "location": "卫生间",
                 "zfStatus": 0,
                 "uvStatus": 0,
                 "iwcStatus": 0,
                 "olStatus": 1,
                 "atHomeEnable": 1,
                 "outerEnable": 1,
                 "sleepEnable": 1
             }
         ],
         "code": "200",
         "msg": "操作成功!"
     }
}

• 返回字段

防区故障、电池欠压、无线干扰、离线几种属于故障类型。“产生”表示产生故障，“恢复”表示故障恢复。

探测器类型名称：

• 返回码

设置探测器状态

• 接口功能

  该接口用于设置设备下关联的探测器在家、外出、睡眠时的布撤防状态（需要设备和探测器支持）

• 请求地址

  https://open.ys7.com/api/lapp/detector/status/set

• 请求方式

  POST

• 子账户token请求所需最小权限

  "Permission":"Config" "Resource":"dev:序列号"

• 请求参数

• HTTP请求报文

POST /api/lapp/detector/status/set HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.9mqitppidgce4y8n54ranvyqc9fjtsrl&deviceSerial=569262222&detectorSerial=604216666&enable=1&safeMode=2

• 返回数据

{
    "code": "200",
    "msg": "操作成功!"
}

• 返回码

删除探测器

• 接口功能

  该接口用于删除设备下关联的探测器（需要设备支持远程删除探测器）

• 请求地址

  https://open.ys7.com/api/lapp/detector/delete

• 请求方式

  POST

• 子账户token请求所需最小权限

  "Permission":"Config" "Resource":"dev:序列号"

• 请求参数

• HTTP请求报文

POST /api/lapp/detector/delete HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.9mqitppidgce4y8n54ranvyqc9fjtsrl&deviceSerial=569262222&detectorSerial=604216666

• 返回数据

{
    "code": "200",
    "msg": "操作成功!"
}

• 返回码

获取可关联的IPC列表

• 接口功能

  该接口用于获取设备可关联的IPC设备列表（需要设备支持）

• 请求地址

  https://open.ys7.com/api/lapp/detector/ipc/list/bindable

• 请求方式

  POST

• 子账户token请求所需最小权限

  "Permission":"Get" "Resource":"dev:序列号"

• 请求参数

• HTTP请求报文

POST /api/lapp/detector/ipc/list/bindable HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.9mqitppidgce4y8n54ranvyqc9fjtsrl&deviceSerial=569262222

• 返回数据

{
    "data": [
        {
            "deviceSerial": "428888888",
            "channelNo": 1,
            "cameraName": "室外"
        },
        {
            "deviceSerial": "426666666",
            "channelNo": 1,
            "cameraName": "室内"
        }
    ],
    "code": "200",
    "msg": "操作成功!"
}

• 返回字段

• 返回码

获取已关联的IPC列表

• 接口功能

  该接口用于获取设备已关联的IPC设备列表（需要设备支持告警联动功能）

• 请求地址

  https://open.ys7.com/api/lapp/detector/ipc/list/bind

• 请求方式

  POST

• 子账户token请求所需最小权限

  "Permission":"Get" "Resource":"dev:序列号"

• 请求参数

• HTTP请求报文

POST /api/lapp/detector/ipc/list/bind HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.8gxgysai9hh0uzr4bnl8jgt23nepm05a&deviceSerial=465538888&detectorSerial=470289999

• 返回数据

{
  "data": [
    {
      "detectorSerial": "470289999",
      "ipcSerial": "558815555"
    }
  ],
  "code": "200",
  "msg": "操作成功!"
}

• 返回字段

• 返回码

设置探测器与IPC的关联关系

• 接口功能

  该接口用于设置设备关联的探测器与IPC设备的关联关系（需要设备支持告警联动功能）

• 请求地址

  https://open.ys7.com/api/lapp/detector/ipc/relation/set

• 请求方式

  POST

• 子账户token请求所需最小权限

  无

• 请求参数

• HTTP请求报文

POST /api/lapp/detector/ipc/relation/set HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.8gxgysai9hh0uzr4bnl8jgt23nepm05a&deviceSerial=465538888&detectorSerial=470289999&ipcSerial=558815555&operation=0

• 返回数据

{
  "code": "200",
  "msg": "操作成功!"
}

• 返回码

修改探测器名称

• 接口功能

  该接口用于修改探测器名称（需要设备支持修改探测器名称）

• 请求地址

  https://open.ys7.com/api/lapp/detector/name/change

• 请求方式

  POST

• 子账户token请求所需最小权限

  无

• 请求参数

• HTTP请求报文

POST /api/lapp/detector/name/change HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.8gxgysai9hh0uzr4bnl8jgt23nepm05a&deviceSerial=465538888&detectorSerial=470289999&newName=mydetector

• 返回数据

{
  "code": "200",
  "msg": "操作成功!"
}

• 返回码

设备一键消警

• 接口功能

  该接口用于实现设备远程消除警报功能（需要设备支持远程一键消警功能）

• 请求地址

  https://open.ys7.com/api/lapp/detector/cancelAlarm

• 请求方式

  POST

• 子账户token请求所需最小权限

  无

• 请求参数

• HTTP请求报文

POST /api/lapp/detector/cancelAlarm HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.8gxgysai9hh0uzr4bnl8jgt23nepm05a&deviceSerial=465538888

• 返回数据

{
  "code": "200",
  "msg": "操作成功!"
}

• 返回码