更新设备绑定信息，支持修改设备关联的用户 ID 和 agent 信息。

• 设备必须已经完成绑定才能进行更新操作。
• 用户 ID 需要先在系统中创建。
• 更新操作会立即生效，影响设备的后续调用。

功能描述

• 更新已绑定设备的用户 ID。
• 更新设备关联的 agent 信息。
• 支持批量更新操作。

请求信息

请求 URI

POST https://rtc-agent.yunxinapi.com/v1/device/update

请求头参数

请求 Header 的参数说明请参考 请求结构。

请求体参数

参数名称	类型	是否必选	示例	说明
deviceId	String	是	device_123456	设备唯一标识符，需要已绑定过
agentId	String	是	agent789	代理标识符，用于标识处理该设备的服务节点
userId	String	是	user_001	用户唯一标识，最大长度 32 字节，只允许字母、数字以及"_@.-"
- customProperties	Array	否	-	设备的自定义属性，用于在 MCP 调用中传递设备信息
key	String	否	deviceType	自定义属性的名称，最多 32 个字符，字符只能是 a-zA-Z0-9 以及 - _
value	String	否	smartSpeaker	自定义属性的值，最多 64 个字符

请求体示例

JSON{
  "deviceId": "device_123456",
  "agentId": "agent789",
  "userId": "user_001",
  "customProperties": [
    {
      "key": "deviceType",
      "value": "smartSpeaker"
    },
    {
      "key": "location",
      "value": "livingRoom"
    }
  ]
}

响应信息

响应参数

参数名称	类型	说明	是否必返回
code	Integer	状态码，200 表示请求成功	是
message	String	提示信息，请求失败时返回错误信息，请求成功时返回"success"	是
requestId	String	请求的唯一标识 ID，用于问题排查和日志跟踪	是
data	Object	响应数据，更新操作成功时为 null	是
success	Boolean	操作是否成功的标识	是

响应体示例

JSON{
  "code": 200,
  "message": "操作成功",
  "requestId": "ai56f35572d3174c45b2ce383297e1847a",
  "data": null,
  "success": true
}