事件流与生命周期
设备列表与扫码绑定
查询名下在线设备与生成手机端扫码绑定票据
1. 查询绑定设备列表 (GET /gateway/device/list)
curl -X GET "http://localhost:58166/gateway/device/list" \
-H "X-AppKey: <your-key>"
{
"code": 200,
"data": [
{
"deviceId": "848bd13e2f9",
"deviceAlias": "深圳运营01机",
"model": "Langhua AI Phone Pro",
"status": "ONLINE",
"battery": 86,
"screenResolution": "1080x2400",
"firmwareVersion": "v1.2.8"
}
]
}
2. 生成绑定二维码票据 (POST /gateway/device-binding/ticket)
上位机调用此接口换取一个有效期 3 分钟的临时 Ticket 并在界面渲染二维码。手机打开扫一扫即可确认绑定：
curl -X POST "http://localhost:58166/gateway/device-binding/ticket" \
-H "X-AppKey: <your-key>"
{
"code": 200,
"data": {
"requestId": "9a12b3c4d5e6",
"ticket": "tkt-bnd-89f1a23e74b0",
"expiresInSeconds": 180
}
}
二维码仅包含临时的 ticket 字符串，不编码任何 AppKey 或长期身份 Token，安全性极高。