查询指定用户的详细信息，包括用户属性和子用户信息，返回用户的完整配置信息。

请求信息

请求 URI

GET https://rtc-agent.yunxinapi.com/v1/ai_users/{uid}

请求头参数

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

请求路径参数

参数名称	类型	是否必选	示例	说明
uid	String	是	test_user_1	用户唯一标识，最大长度32字节

请求查询参数

参数名称	类型	是否必选	示例	说明
subAccountUid	String	否	sub_user_01	子用户ID，最大长度32字节，只允许字母、数字以及"_@.-"。

响应信息

响应参数

参数名称	类型	说明	是否必返回
code	Integer	状态码，200表示请求成功	是
message	String	提示信息，请求失败时返回错误信息，请求成功时返回"success"	是
- data	Object	返回的JSON数据对象，请求失败则返回空对象	是
uid	String	用户唯一标识	是
note	String	用户备注信息	否
- userProperties	Object	用户属性对象	否
gender	String	性别，如"MALE"、"FEMALE"	否
birthYear	Integer	出生年份	否
name	String	用户姓名	否
- subAccounts	Array	子用户数组	否
uid	String	子用户唯一标识	是
note	String	子用户备注信息	否
- userProperties	Object	子用户属性对象	否
gender	String	子用户性别	否
birthYear	Integer	子用户出生年份	否
name	String	子用户姓名	否

响应体示例

JSON{
  "code": 200,
  "message": "success",
  "data": {
    "uid": "test_user_1",
    "note": "主用户账户",
    "userProperties": {
      "gender": "MALE",
      "birthYear": 1991,
      "name": "TestName"
    },
    "subAccounts": [
      {
        "uid": "sub_user_01",
        "note": "子用户账户1",
        "userProperties": {
          "gender": "FEMALE",
          "birthYear": 1995,
          "name": "SubTestName"
        }
      }
    ]
  }
}

错误码

完整列表请参考 错误码 。