Open Platform
Skip to content

A localized solution for detecting whether the multi-function keyboard firmware needs an upgrade. ​

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

Use existing multifunction keyboard information to detect whether the multifunction keyboard firmware needs to be upgraded.

1 Request example ​

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

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

2 Request parameters ​

NameTypeRequiredDescription
secretStringYThe secret is manually assigned to the customer by Tongtonglock and is used for interface access control.
modelNumStringYProduct model (used for firmware upgrades), returned during gateway initialization.
hardwareRevisionStringYHardware version number (used for firmware upgrades), returned during gateway initialization.
firmwareRevisionStringYFirmware version number (used for firmware upgrades), returned during gateway initialization.
accountLongNUser account, used to configure upgrades for specific users.

3 Response and example ​

ParameterTypeDescription
needUpgradeIntUpgrade required: 0 - No, 1 - Yes
firmwareInfoStringFirmware information
firmwarePackageStringFirmware package
versionStringLatest firmware version number
{
    "needUpgrade":1,
    "firmwareInfo":{
        "modelNum":"SN843",
        "hardwareRevision":"1.1.2",
        "firmwareRevision":"1.1.0"
    },
 "firmwarePackage":"NzQsMTksODUsODQsODIsNjcsNzIsNjUsNjksODgsOTQsOTUsMTIyLDg0LDcyLDE5LDExLDE5LDAsNywzLDQsMCwwLDYsMCw2LDUsOCw4LDEsMSwxLDEsMTksMjksMTksNjgsNjcsOTMsMTksMTEsMTksODksNjksNjksNjUsNjYsMTEsMzAsMzAsNjQsODgsOTUsODgsNjgsNjUsODAsODIsOTAsODAsODYsODQsMzEsNjYsODIsODgsODQsOTUsODQsNjcsMzEsODIsOTUsMzAsODcsODgsNjcsOTIsNzAsODAsNjcsODQsMzAsOTgsMTI3LDExMCwzLDMsNiwxMTAsMTAzLDAsMzEsMCwzMSwzLDExMCwxMDMsMCwzMSwzLDMxLDMsMCwzMSwxLDQsMyw1LDI1LDEsMiwyNCwzMSw3NSw4OCw2NSwxOSw3NiwxMQ==",
    "version":"2.0"
}
CopyRight © 2012-2026 TTLock.All Rights Reserved