查询设备电量记录

GET

/v2/stats/battery/{device_id}

查询设备上报的电量记录，目前 5 分钟内只能接受一次上报；6 小时内只接受有变化的上报记录(和服务器最后一次保存的数据不同)

请求参数

Path 参数

Query 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/v2/stats/battery/3D3YHZSUYHCX?start_time=1741655492&end_time=1741860692&offset=0&limit=10&direction=0' \
--header 'X-Tg-App-Id: xxx' \
--header 'X-Tg-Platform: {{platform}}' \
--header 'X-Tg-Sdk-Version: 23910000' \
--header 'X-Tg-App-Store: {{appstore}}' \
--header 'X-Tg-App-Version: {{app_version}}' \
--header 'X-Tg-App-Pkgname: {{pkgname}}' \
--header 'X-Tg-Date: {{currentUTCTime}}' \
--header 'Accept-Language: zh-CN' \
--header 'Authorization: '

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 200,
    "msg": "ok",
    "data": [
        {
            "qoe": 0,
            "is_qoe_low": true,
            "is_charging": true,
            "ip": "string",
            "reporter": "string",
            "create_time": 0,
            "update_time": 0
        }
    ]
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2026-01-09 04:05:25