查询设备电量记录 - 探鸽开放平台API文档

请求参数

Path 参数

device_id

string

设备 ID

必需

示例值:

3D3YHZSUYHCX

Query 参数

start_time

integer

开始时间戳

必需

示例值:

1741655492

end_time

integer

截止时间戳

必需

示例值:

1741860692

offset

integer

翻页.起始偏移量

可选

示例值:

0

limit

integer

翻页.每页记录数

可选

示例值:

10

direction

integer

可选

排序方向：0按时间升序、1按时间降序

示例值:

0

Header 参数

X-Tg-App-Id

string

必需

开发者帐号的APPID

默认值:

X-Tg-Platform

string

必需

请求来源：android/ios/pc/web/device

默认值:

示例值:

androidiOSwebdevicepc

X-Tg-Sdk-Version

string

必需

API SDK版本号：1024

默认值:

Accept-Language

string

必需

请求端的本地语言（zh-cn, zh-tw, en-us, ja, ko, vi, es, pt, ru, tr, de, it, fr, pl, th, ar）

默认值:

示例值:

zh-cnzh-twen-usjakoviesptrutrdeitfrplthar

X-Tg-App-Store

string

手机APP应用商店

可选

默认值:

X-Tg-App-Pkgname

string

手机APP包名

必需

默认值:

Authorization

string

必需

服务端接口时传入签名计算后的字符串。客户端APP传入用户登陆态数据access_token。两者不要混用。

默认值:

X-Tg-Date

string

必需

当前请求的UTC+0时间（注意时区，不是本地时区）

默认值:

20060102T150405Z

X-Tg-App-Version

string

APP版本号

可选

默认值:

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

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;' \
--header 'X-Tg-Platform;' \
--header 'X-Tg-Sdk-Version;' \
--header 'Accept-Language;' \
--header 'X-Tg-App-Store: {{appstore}}' \
--header 'X-Tg-App-Pkgname;' \
--header 'Authorization;' \
--header 'X-Tg-Date;' \
--header 'X-Tg-App-Version: {{app_version}}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

示例值:

200

msg

string

必需

示例值:

ok

data

array[object (设备ID) {7}]

必需

qoe

integer

电量百分比

必需

-1表示未上报

is_qoe_low

boolean

是否低电

必需

is_charging

boolean

是否充电中

必需

ip

string

设备 IP 地址

必需

reporter

string

上报者

必需

create_time

integer

创建时间

必需

update_time

integer

修改时间

必需

示例

{
    "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服务器内部错误