Open Platform
Skip to content

Upgrade check ​

https://cnapi.ttlock.com/v3/lock/upgradeCheck

Check to see whether there is any upgrade for a lock. If there is no version info on the server, returns 'unknown'. In this case, you need to call APP SDK method to get lockData, and then request cloud API: Upgrade recheck to recheck for upgrading.

1 Request example ​

POST, ContentType:application/x-www-form-urlencoded

javascript
curl --location -g --request POST 'https://cnapi.ttlock.com/v3/lock/upgradeCheck' \
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
--data-urlencode 'lockId=163377' \
--data-urlencode 'date=1625025703000'

2 Request parameters ​

NameTypeRequiredDescription
clientIdStringYclient_id from Create application
accessTokenStringYAccess token,refer to: Get access token
lockIdIntYLock ID, generated by Lock init
dateLongYCurrent time (timestamp in millisecond)

3 Response and example ​

ParameterTypeDescription
needUpgradeIntIs upgrading available: 0-No, 1-Yes, 2-Unknown
firmwareInfoStringLock firmware info
firmwarePackageStringFirmware package
versionStringLatest firmware version
{
    "needUpgrade":1,
    "firmwareInfo":{
        "modelNum":"SN242-SYNO_PV53",
        "hardwareRevision":"1.1",
        "firmwareRevision":"5.1.0.200305"
    },
 "firmwarePackage":"LTIwLC03NSwtMTMsLTE0LC0xMiwtMjcsLTE4LC0yNSwtMjksLTIsLTgsLTcsLTM2LC0xNCwtMTgsLTc1LC04MywtNzUsLTkwLC05NSwtOTEsLTkxLC05NCwtOTAsLTkzLC05MCwtOTQsLTgyLC05MywtODEsLTgyLC04OSwtODksLTg5LC03NSwtNjksLTc1LC0zMCwtMjcsLTUsLTc1LC04MywtNzUsLTEsLTI5LC0yOSwtMjUsLTgzLC03MiwtNzIsLTI2LC0yLC03LC0yLC0zMCwtMjUsLTEwLC0xMiwtNCwtMTAsLTE2LC0xNCwtNzEsLTI4LC0xMiwtMiwtMTQsLTcsLTE0LC0yNywtNzEsLTEyLC03LC03MiwtMTUsLTIsLTI3LC02LC0zMiwtMTAsLTI3LC0xNCwtNzIsLTYwLC0zOSwtNTYsLTkxLC05MywtOTEsLTY1LC00NSwtODksLTkwLC01NiwtNjAsLTUwLC0zOSwtNDAsLTY2LC01NiwtNjMsLTk0LC03MSwtOTIsLTcxLC05MiwtNzEsLTkxLC05MCwtODksLTk0LC05MSwtODksLTY1LC04OSwtOTAsLTY2LC03MSwtMTksLTIsLTI1LC03NSwtMjIsNzk=",
    "version":"5.3.3.210520"
}
CopyRight © 2012-2026 TTLock.All Rights Reserved