查询设备在线状态

POST

/v2/device/online

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

请求参数

Header 参数

Body 参数application/json

示例

{
    "device_id": "633U5DMHS8HW"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/device/online' \
--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}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "device_id": "633U5DMHS8HW"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 200,
    "msg": "ok",
    "data": {
        "1702D8OBYWWQ": {
            "is_online": 0,
            "up_at": 0,
            "down_at": 0,
            "live_time": 0,
            "dormant_status": {
                "is_alive": true,
                "last_heartbeat_data": "string",
                "last_heartbeat_time": 0,
                "sleep_login_time": 0,
                "last_offline_time": 0
            }
        }
    }
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2025-08-10 09:58:13

查询设备连接信息

门锁开锁.预授权