Open Platform
Skip to content

Administrator obtains water meter details ​

https://cnapi.ttlock.com/v3/waterMeter/detail

1 Request example ​

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

json
curl --location -g --request POST 'https://cnapi.ttlock.com/v3/waterMeter/detail'\
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
--data-urlencode 'waterMeterId=3001' \
--data-urlencode 'date=1625025703000'

2 Request parameters ​

NameTypeRequiredDescription
clientIdStringYAssigned client_id from created application
accessTokenStringYAccess token, obtain by calling get access token API
dateLongYCurrent time (timestamp, in milliseconds)
waterMeterIdIntYWater Meter ID

3 Response and example ​

NameTypeDescription
waterMeterIdIntWater Meter ID
nameStringWater meter name
numberStringWater meter number
macStringWater meter MAC
featureValueStringFeature value
modelNumStringProduct Model
hardwareRevisionStringHardware version number
firmwareRevisionStringFirmware version number
payModeIntOperating modes: 0 - Energy metering mode; 1 - Prepaid mode
syncM3DateStringMeter reading time
onlineIntOnline status: 0 - No 1 - Yes
rssiIntSignal strength
onOffIntWater flow status
totalM3StringTotal water consumption
remainderM3StringRemaining water volume
priceStringUnit price
maxPowerStringMaximum power
groupNameStringGroup Name
groupIdIntGroup ID
electricQuantityIntBattery
json
{
    "syncM3Date": 1750748374000,
    "modelNum": "SN774-V01",
    "payMode": 0,
    "groupId": 92,
    "waterMeterId": 296,
    "remainderM3": "10.00",
    "mac": "78:58:44:00:01:41",
    "totalM3": "9.89",
    "featureValue": "00000000",
    "number": "EM2_410100",
    "groupName": "1",
    "hardwareRevision": "1.3",
    "name": "water meter",
    "online": 0,
    "maxPower": "255",
    "firmwareRevision": "1.1.27.250326",
    "onOff": 1
}

3.1 Feature value description ​

Similar to lock feature value, meter feature value are also hexadecimal strings that indicate what functions the meter supports.

Description of the function of each byte bit (counting from 0) after high-low bit conversion: ​
BitExplanation
0Supports 4G networks, but does not support adding tasks.
1Supports 4G networks, and supports adding tasks.
CopyRight © 2012-2026 TTLock.All Rights Reserved