Open Platform
Skip to content

Gateway firmware upgrade check for on-premise solution ​

https://cnapi.ttlock.com/v3/gateway/upgradeCheckForOnPremise

Check if there is upgrade patch available for a gateway with it's gateway information.

1 Request example ​

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

javascript
curl --location -g --request POST 'https://cnapi.ttlock.com/v3/gateway/upgradeCheckForOnPremise' \
--data-urlencode 'secret=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'modelNum=SN227' \
--data-urlencode 'hardwareRevision=1.1.2' \
--data-urlencode 'firmwareRevision=1.1.0' \
--data-urlencode 'account=1232131231'

2 Request parameters ​

NameTypeRequiredDescription
secretStringYThe secret from TTLock company
modelNumStringYProduct model, from init gateway SDK
hardwareRevisionStringYHardware version, from init gateway SDK
firmwareRevisionStringYFirmware version, from init gateway SDK
accountLongNUser account,check for a specific user. We may configure a upgrade patch for a specific user account.

3 Response and example ​

ParameterTypeDescription
needUpgradeIntIs upgrading available: 0-No, 1-Yes
firmwareInfoStringFirmware info
firmwarePackageStringfirmware package
versionStringLatest firmware version
{
    "needUpgrade":1,
    "firmwareInfo":{
        "modelNum":"SN227",
        "hardwareRevision":"1.1.2",
        "firmwareRevision":"1.1.0"
    },
 "firmwarePackage":"NzQsMTksODUsODQsODIsNjcsNzIsNjUsNjksODgsOTQsOTUsMTIyLDg0LDcyLDE5LDExLDE5LDAsNywzLDQsMCwwLDYsMCw2LDUsOCw4LDEsMSwxLDEsMTksMjksMTksNjgsNjcsOTMsMTksMTEsMTksODksNjksNjksNjUsNjYsMTEsMzAsMzAsNjQsODgsOTUsODgsNjgsNjUsODAsODIsOTAsODAsODYsODQsMzEsNjYsODIsODgsODQsOTUsODQsNjcsMzEsODIsOTUsMzAsODcsODgsNjcsOTIsNzAsODAsNjcsODQsMzAsOTgsMTI3LDExMCwzLDMsNiwxMTAsMTAzLDAsMzEsMCwzMSwzLDExMCwxMDMsMCwzMSwzLDMxLDMsMCwzMSwxLDQsMyw1LDI1LDEsMiwyNCwzMSw3NSw4OCw2NSwxOSw3NiwxMQ==",
    "version":"2.0"
}
CopyRight © 2012-2026 TTLock.All Rights Reserved