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

更新时间：2023-06-15 05:59:40

本文介绍查询用电设备的电量充值记录的 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
}

错误码

参考错误码。