接口列表

本节包含设备开关状态操作的相关接口等。

接口列表如下：

获取设备版本信息

• 接口功能

  查询用户下指定设备的版本信息

• 请求地址

  https://open.ys7.com/api/lapp/device/version/info

• 请求方式

  POST

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

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

• 请求参数

• HTTP请求报文

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

accessToken=at.dunwhxt2azk02hcn7phqygsybbw0wv6p&deviceSerial=427734888

• 返回数据

{
    "data": {
        "latestVersion": "V5.2.7 build 170628",
        "currentVersion": "V5.2.6 build 160919",
        "isNeedUpgrade": 1,
        "isUpgrading": 1
    },
    "code": "200",
    "msg": "操作成功!"
}

• 返回字段

注：萤石型号设备可根据isNeedUpgrade字段是否为1或比较当前版本和最新版本是否一致来确认设备是否需要升级，海康型号设备只能根据isNeedUpgrade字段是否为1确认设备是否需要升级。

• 返回码

设备升级固件

• 接口功能

  升级设备固件至最新版本

• 请求地址

  https://open.ys7.com/api/lapp/device/upgrade

• 请求方式

  POST

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

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

• 请求参数

• HTTP请求报文

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

accessToken=at.20h863523v1zfck75qgmwhoy7vl2teqp&deviceSerial=427734888

• 返回数据

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

• 返回码

获取设备升级状态

• 接口功能

  查询用户下指定设备的升级状态，包括升级进度。

• 请求地址

  https://open.ys7.com/api/lapp/device/upgrade/status

• 请求方式

  POST

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

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

• 请求参数

• HTTP请求报文

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

accessToken=at.20h863523v1zfck75qgmwhoy7vl2teqp&deviceSerial=427734888

• 返回数据

{
    "data": {
        "progress": 43,
        "status": 0
    },
    "code": "200",
    "msg": "操作成功!"
}

• 返回字段

• 返回码