查询设备在线信息(V3)

测试中

POST

/v3/device/server/online

长电设备：在线状态及时刷新，离线状态会等待三次心跳包（75秒内）均无效才会置为离线
低功耗设备：在线状态及时刷新，离线状态会等待三次心跳包（300秒内）均无效才会置为离线

请求参数

Header 参数

Body 参数application/json

示例

{
    "device_id": "5A3DMNHS7DMC"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v3/device/server/online' \
--header 'X-Tg-Signed-Headers: content-length;content-type;x-tg-app-id;x-tg-date' \
--header 'X-Tg-App-Id: xxx' \
--header 'X-Tg-Date: {{currentUTCTime}}' \
--header 'X-Tg-Algorithm: TGV1-HMAC-SHA256' \
--header 'X-Tg-Content-Sha256;' \
--header 'Accept-Language: zh-CN' \
--header 'Authorization: ' \
--header 'X-Tg-Api-Version: 2.1' \
--header 'Content-Type: application/json' \
--data-raw '{
    "device_id": "5A3DMNHS7DMC"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 200,
    "data": {
        "6E49NLF39KX3": {
            "client_addr": "192.61.85.172:46929",
            "dormant_status": {
                "is_alive": true,
                "last_heartbeat_data": "60,0",
                "last_heartbeat_time": 1743246848,
                "last_offline_time": 1743242733,
                "sleep_login_time": 1743242733
            },
            "down_at": 1743242735,
            "is_online": true,
            "live_time": -1,
            "register_status": {
                "down_at": 1743242735,
                "is_online": false,
                "up_at": 1743242704
            },
            "up_at": 1743242733
        }
    },
    "msg": "ok",
    "ok": 1,
    "requestid": "fe023cca-35a5-4c20-95c6-58ae3c4988d7",
    "status": "ok"
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2026-03-27 12:46:29