跳转到主要内容
开始创作
开发文档

获取用户设备列表

获取本应用下已绑定且已激活的设备列表,含关联智能体信息。传入 userId 时仅返回该用户的设备,不传则返回应用下全部设备。

获取本应用下已绑定且已激活的设备列表,含关联智能体信息。传入 userId 时仅返回该用户的设备,不传则返回应用下全部设备。

POST /openapi/v1/devices/user/list

请求参数

参数

类型

响应示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "list": [
      {
        "id": 1,
        "agent_id": 42,
        "device_name": "客厅音箱",
        "mac": "AA:BB:CC:DD:EE:FF",
        "mode": "auto",
        "auth_status": "approved",
        "agent": { "id": 42, "name": "小助手" }
      }
    ],
    "total": 1
  }
}