1. API List

This section contains the APIs used for enabling or disabling device function status。

See the following list：

No. Function Description
1 Get device version Get device version information
2 Upgrade device firmware Upgrade device firmware
3 Get device upgrade status Get device upgrade status, including upgrade progress, status and so on.

1.1 Get Device Version Information

  • API Function

    Search the specified device version information.

  • Request Address

    {areaDomain}/api/lapp/device/version/info

  • Request Type

    POST

  • Request Parameters
Parameter Name Type Description Required
accessToken String Obtained access_token during assigning permission Y
deviceSerial String Device serial No. Y
  • HTTP Request Message
    POST /api/lapp/device/encrypt/off HTTP/1.1
Host: isgpopen.ezvizlife.com
Content-Type: application/x-www-form-urlencoded
accessToken=at.8z25h2063dapeus7c99bb0r6e0kjfjz5&deviceSerial=427734888&validateCode=ABCDEF
  • Return Data
    {
  "data": {
      "latestVersion": "V4.2.5 build 151223",
  "currentVersion": "V4.2.5 build 151223"

      },
  "code": "200",
  "msg": "Operating succeeded!"
}
</pre>
  • Return Field
Field Name Type Description
latestVersion String Latest version
currentVersion String Current version
  • Return Code
Return Code Return Information Description
200 Operating succeeded. Request succeeded.
10001 Parameter error. The parameter is empty or incorrect format.
10002 accessToken exception or expired. Re-get the accessToken
10005 appKey exception appKey is frozen.
20002 The device does not exist.
20014 Illegal deviceSerial
20018 Illegal deviceSerial Chcek whether the device is belong to the current account.
49999 Data exception. API call exception.

1.2 Upgrade Device Firmware

  • API Function

    Upgrade device firmware to the latest version.

  • Request Address

    {areaDomain}/api/lapp/device/upgrade

  • Request Type

    POST

  • Request Parameters
Parameter Name Type Description Required
accessToken String Obtained access_token during assigning permission Y
deviceSerial String Device serial No. Y
  • HTTP Request Message
    POST /api/lapp/device/encrypt/off HTTP/1.1
Host: isgpopen.ezvizlife.com
Content-Type: application/x-www-form-urlencoded
accessToken=at.8z25h2063dapeus7c99bb0r6e0kjfjz5&deviceSerial=427734888&validateCode=ABCDEF
  • Return Data 
    {
  "code": "200",
  "msg": "Operating succeeded!"
}
  • Return Code
Return Code Return Information Description
200 Operating succeeded. Request succeeded.
10001 Parameter error. The parameter is empty or incorrect format.
10002 accessToken exception or expired. Re-get the accessToken
10005 appKey exception appKey is frozen.
20002 The device does not exist.
20006 Network exception. Check the device network status. Try later.
20007 Device offline. Check the device online status.
20008 Device response overtime. Too many operations. Try later.
20014 Illegal deviceSerial
20018 No this device. Chcek whether the device is belong to the current account.
49999 Data exception. API call exception.
60013 Already the latest version.
60014 Device is upgrading.
60015 Device is rebooting
60016 Device upgrade failed. Check device network status.

1.3 Get Device Upgrade Status

  • API Function

    Search the upgrade status, inclduing the upgrade progress of specified device。

  • Request Address

    {areaDomain}/api/lapp/device/upgrade/status

  • Request Type

    POST

  • Request Parameters
Parameter Name Type Description Required
accessToken String Obtained access_token during assigning permission Y
deviceSerial String Device serial No. Y
  • HTTP Request Message
    POST /api/lapp/device/encrypt/off HTTP/1.1
Host: isgpopen.ezvizlife.com
Content-Type: application/x-www-form-urlencoded
accessToken=at.8z25h2063dapeus7c99bb0r6e0kjfjz5&deviceSerial=427734888&validateCode=ABCDEF
  • Return Data
    {
  "data": {
      "progress": 43,
  "status": 0

      },
  "code": "200",
  "msg": "Operating succeeded!"
}
</pre>
  • Return Field
Field Name Type Description
progress int Upgrade progress,valid only in upgrading staus, ranging from 1 to 100
status int Upgrade status: 0-Upgrading, 1-Device reboot, 2-Upgraded, 3- Upgrading failed.
  • Return Code
Return Code Return Information Description
200 Operating succeeded. Request succeeded.
10001 Parameter error. The parameter is empty or incorrect format.
10002 accessToken exception or expired. Re-get the accessToken
10005 appKey exception appKey is frozen.
20002 The device does not exist.
20007 Device offline Check the device online status.
20014 Illegal deviceSerial
20018 No this device. Chcek whether the device is belong to the current account.
49999 Data exception. API call exception.

results matching ""

    No results matching ""