智读表API文档

根据设备名查找设备

基本信息

API前缀:详见简介

Path: /manage/device/deviceName

Method: GET

接口描述: 这个接口以及过时,请参考下面/manage/v2/device/deviceName

请求参数

Query

参数名称 是否必须 示例 备注
deviceName zb14hjk23uuuu 设备名(UUID序列号)
access_token 246e5b20-8eb7-4c6d-8d2f-8652a4b2842b 访问令牌,获取步骤详见 获取或者刷新token

返回数据

{
  "code": 200,
  "msg": "OK",
  "data": {
          "id": 103,    //设备id                       
          "deviceName": "542a436b9c3b02f3", //设备名称(UUID序列号)
          "deviceTypeCode": 263,            //设备类型code
          "productId": 2,                   //产品id
          "deviceSecret": "COLsZpbqZj7lQxuRLVKQZdWBg55rZm2t",//密钥
          "productKey": "ZOtDKJz6YLm",                       //产品key
          "gmtCreate": "2019-03-08 21:33:04",                //创建时间
          "deviceStatus": 2,                                 //设备状态
          "longitude": null,                                  //经度
          "latitude": null,                                   //纬度
          "height": null,                                     //高度
          "networkType": 5,                                   //网络类型
          "description": "test_sever",                        //设备描述
          "sysVersion": "3.0.4",                              //系统版本号(固件版本号)
          "electricity": null,                                //电量
          "requestId": null,                                  //请求id
          "periodId": null,                                   //周期id
          "lastTime": null,                 
          "lastLogin": "2019-03-08 23:22:24",                 //上次登录时间
          "signal": null,                                     //信号
          "powerSupply": false,                               //供电方式,0电池供电,1电源供电
          "newBattery": 1,                                    //旧电池0,新电池1,电源供电2
          "batteryCapacity": 3800,                            //电池容量
          "meterNumber": null,                                //表计编号
          "houseNumber": null,                                //户号
          "houseName": null,                                  //户名
          "caliber": null,                                    //口径
          "meterLocationNumber": null,                        //表计位号
          "address": null,                                    //安装地址
          "maxCorrectValue": 500,
          "minCorrectValue": 10,
          "value": null,                                      
          "cValue": null,                                     
          "localIncrement": null,
          "cloudIncrement": null,
          "autoCorrecte": false,
          "repairStatus": "1",
          "dataServerIp": "0.0.0.0",
          "dataServerPort": 0,
          "recentPicPath": null,
          "energyId": null,
          "functionCode": null,
          "buildingId": null,
          "dataFrom": 0,                                       //数据源:0云端识别,1本地识别
          "unit": null,
          "magnification": null,
          "dataBeanList": null,
          "deviceMotor": null
                            }
}

根据设备名查找设备

基本信息

API前缀:详见简介

Path: /manage/v2/device/deviceName

Method: GET

接口描述:

请求参数

Query

参数名称 是否必须 示例 备注
deviceName zb14hjk23uuuu 设备名(UUID序列号)
access_token 246e5b20-8eb7-4c6d-8d2f-8652a4b2842b 访问令牌,获取步骤详见 获取或者刷新token

返回数据

{
    "code":200,
    "msg":"OK",
    "data":{
        "id":44497,                                      //设备id
        "deviceName":"zb14hjk23uuuu",                    //设备名
        "deviceTypeCode":300,                            //设备类型code
        "productId":3074,                                //产品id
        "deviceSecret":"sxujWoWNtZ9rlvOJ8wVfEfFZrlGOZUhZ",//设备密钥
        "productKey":"xOtSGlrmmc0",                       //产品key
        "gmtCreate":"2022-11-21 16:29:59",                //创建时间
        "deviceStatus":2,                                 //设备状态
        "longitude":0,                                    //经度
        "latitude":0,                                     //纬度
        "height":0,                                       //高度
        "networkType":13,                                 //网络类型
        "description":"",                                 //描述
        "sysVersion":"1.0.39",                            //固件版本号
        "electricity":99.77,                              //电量
        "requestId":null,                                 //请求id
        "periodId":"b80c6c79-c275-43f9-bb67-1ff0e8632b38",//周期id
        "lastTime":"2022-12-05 11:19:02",                 //最新上报时间
        "lastLogin":null,                                 //上传登录时间
        "signal":"-86.0",                                 //信号值
        "powerSupply":false,                              //供电方式,0电池供电,1电源供电
        "newBattery":0,                                   //旧电池0,新电池1,电源供电2
        "batteryCapacity":8500,                           //电池容量
        "meterNumber":null,                               //表计编号
        "houseNumber":"水表",                              //户号
        "houseName":null,                                 //户名
        "caliber":null,                                   //口径
        "meterLocationNumber":null,                       //表计位号
        "address":null,                                   //地址
        "maxCorrectValue":-1,                             
        "minCorrectValue":-1,
        "value":null,                                    //本地识别值
        "cValue":99947,                                  //云端识别值
        "localIncrement":null,                           //本地增量
        "cloudIncrement":0,                              //云端增量
        "lightValue":null,
        "autoCorrecte":false,
        "repairStatus":"0",
        "dataServerIp":"0.0.0.0",
        "dataServerPort":0,
        "recentPicPath":"https://www.smartmetering.top/staticfile/pic/xOtSGlrmmc0/869915047668958/2022/12/5/1670210342_s.jpg",//图片地址
        "energyId":null,
        "functionCode":null,
        "buildingId":null,
        "dataFrom":0,                                    //数据源,0本地识别,1云端识别
        "unit":null,                                     //单位
        "magnification":"1",                             //倍率
        "useCode":1,                                     //用途分类
        "fontCode":null,
        "paramList":null,
        "dataBeanList":null,
        "deviceMotor":null
    }
}