云服务 API 参考行业场景垂直行业解决方案用电管控用电管理查询用电设备的电量充值记录

查询用电设备的电量充值记录

更新时间：2023-06-21 07:13:05下载pdf

本文介绍查询用电设备的电量充值记录的 API。

接口描述

查询用电设备的指定时间范围内的电量充值记录。

接口地址

GET: /v1.0/iot-03/power-devices/{device_id}/charge-records

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	uri	true	设备 ID
start_time	Long	query	true	开始时间。开始时间必需小于结束时间，且开始时间必需在当前时间的前 30 天之内
end_time	Long	query	true	结束时间。结束时间必需大于开始时间，且开始时间至结束时间的范围小于 7 天
last_row_key	String	query	false	最后条业务记录
size	Integer	query	false	页大小。小于 100 的正整数

返回参数

参数名	类型	说明
result	CursorPage	分页电量充值记录。

result 说明

参数名	类型	说明
has_more	Boolean	true：有更多数据 false：没有更多数据
list	List	电量充值记录
last_row_key	String	最后条数据键

list 说明

参数名	类型	说明
charge_time	Long	电量充值时间
charge_value	Double	充值电量值

请求示例

GET: /v1.0/iot-03/power-devices/6c31820d9e02f8db7e****/charge-records?start_time=1637652798985&end_time=1637768682437

返回示例

{
    "result": {
        "last_row_key": "20370E02F0617161B0F85098C0E1F9E655203E58AD610DC9C386E4C14F95D16F705AFD65C64B20132702D2F146F5****",
        "list": [
            {
                "charge_value": 2,
                "charge_time": 1637768682437
            },
            {
                "charge_value": 15,
                "charge_time": 1637758079188
            },
            {
                "charge_value": 15,
                "charge_time": 1637758067950
            },
            {
                "charge_value": 15,
                "charge_time": 1637737706465
            },
            {
                "charge_value": 14,
                "charge_time": 1637737664031
            },
            {
                "charge_value": 14,
                "charge_time": 1637737649861
            },
            {
                "charge_value": 1,
                "charge_time": 1637737518886
            },
            {
                "charge_value": 1,
                "charge_time": 1637652798985
            }
        ],
        "has_more": false
    },
    "t": 1637809778328,
    "success": true
}

错误码

参考错误码。