连接设备

创建设备连接会话

接口信息

项目	值
请求方法	POST
请求路径	`/devices/{device_id}/connect`

路径参数

参数	类型	必填	说明
device_id	string	是	设备 ID

请求参数

参数	类型	必填	说明
duration	number	否	会话时长（分钟），默认 30
app_id	string	否	自动安装的应用 ID

请求示例

curl -X POST "https://api.pandatest.net/v1/devices/device_001/connect" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "duration": 60,
    "app_id": "app_123"
  }'

响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "session_id": "session_abc123",
    "device_id": "device_001",
    "status": "connecting",
    "stream_url": "wss://stream.pandatest.net/session_abc123",
    "control_url": "wss://control.pandatest.net/session_abc123",
    "expires_at": "2024-01-15T12:30:00Z"
  }
}

响应字段

字段	类型	说明
session_id	string	会话 ID
device_id	string	设备 ID
status	string	状态：connecting/connected/disconnected
stream_url	string	屏幕流 WebSocket 地址
control_url	string	控制指令 WebSocket 地址
expires_at	string	会话过期时间

断开连接

curl -X POST "https://api.pandatest.net/v1/sessions/session_abc123/disconnect" \
  -H "Authorization: Bearer YOUR_API_KEY"

错误码

错误码	说明
40004	设备不存在
40010	设备正在使用中
40011	配额不足