Skip to content

获取电表列表 ​

https://cnapi.ttlock.com/v3/electricMeter/list

通过该接口获取用户在通通锁APP里添加的电表,或是对接APP SDK通过初始化锁接口初始化的电表。

通通锁APP添加的电表,请用添加电表时的APP的账号和密码获取访问令牌后调用该接口。

云端初始化锁接口初始化的电表,请使用初始化电表时相同用户的访问令牌。

1 HTTP请求方法及示例 ​

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

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

2 参数说明 ​

名称类型是否必需描述
clientIdStringY创建应用分配的client_id
accessTokenStringY访问令牌,通过获取访问令牌接口获取
dateLongY当前时间(时间戳,单位毫秒)
groupIdIntN分组ID
searchStrStringN搜索条件,支持搜索表名称以及表号电表ID列表
pageNoIntY页码,从1开始
pageSizeIntY每页数量,最大1000

3 返回参数及示例 ​

参数类型描述
listJSONObject列表
totalInt总条数

列表中的对象

参数类型描述
electricMeterIdInt电表ID
onlineInt是否在线: 0-否 1-是
rssiInt信号强度
onOffInt通电状态: 0-否 1-是 2-未知
nameString电表名称
numberString表号
payModeInt工作模式: 0-计能模式 1-预付费
totalKwhString总用电量
remainderKwhString剩余电量
priceString单价
json
{
   "total": 1,
   "list": [
        {
            "number": "EM2_005012",
            "payMode": 1,
            "price": "10.00",
            "name": "EM2_005012",
            "online": 0,
            "electricMeterId": 270,
            "remainderKwh": "0.00",
            "onOff": 1,
            "totalKwh": "0.00"
        }
    ]
}