查询关联账号列表3.8.2.SP2+

只允许获取非归档状态下用户的关联账号

接口说明

请求URL：http[s]://{网关地址}/minos-platform/user/getRelUserList

请求方式： POST

请求内容类型： application/json

响应内容类型： application/json

请求说明

请求体

字段名	参数名	必填	类型	描述
用户名(学工号)	userId	M	String	用户名/学工号,最大20个字符

请求示例

{
  "userId":"20251224INHERIT02"
}

响应说明

响应体

参数名	类型	描述
errcode	String	返回码
errmsg	String	返回描述
data	List<RelUserInfo>	返回数据

RelUserInfo

字段名	参数名	类型	描述
用户WID	wid	String	系统内部用户编码
自然人ID	personWid	String	自然人编码
用户名/学工号	userId	String	用户名/学工号，最大20个字符
姓名	userName	String	用户姓名，最大200个字符
身份分类代码	categoryCode	String	身份分类代码
身份分类名称	categoryName	String	身份分类名称
生命周期状态	lifeCycle	String	生命周期 0：未入校 1：入校 2：离校
生命周期到期时间	lifeCycleExpire	String	生命周期到期时间，格式yyyy-MM-dd
激活状态	activeStatus	String	激活状态 0未激活 1正常
账号状态	accountStatus	String	账号状态 1正常 2冻结 4禁用
是否主账号	isPrimary	String	是否主账号 0否 1是

响应示例

{
  "data": [
    {
      "accountStatus": "1",
      "activeStatus": "1",
      "categoryCode": "1448358111789551616",
      "categoryName": "学生2/学生测试",
      "isPrimary": "1",
      "lifeCycle": "1",
      "lifeCycleExpire": "",
      "personWid": "25C0001Y",
      "userId": "20251224INHERIT03",
      "userName": "D003",
      "wid": "1458153459991027712"
    },
    {
      "accountStatus": "1",
      "activeStatus": "1",
      "categoryCode": "1448358111789551616",
      "categoryName": "学生2/学生测试",
      "isPrimary": "0",
      "lifeCycle": "1",
      "lifeCycleExpire": "",
      "personWid": "25C0001Y",
      "userId": "20251224INHERIT02",
      "userName": "D003",
      "wid": "1458153100031664128"
    },
    {
      "accountStatus": "4",
      "activeStatus": "1",
      "categoryCode": "1448358111789551616",
      "categoryName": "学生2/学生测试",
      "isPrimary": "0",
      "lifeCycle": "1",
      "lifeCycleExpire": "",
      "personWid": "25C0001Y",
      "userId": "20251224DUP02",
      "userName": "D003",
      "wid": "1453425470480945152"
    }
  ],
  "errcode": "0",
  "errmsg": "操作成功",
  "success": true
}

错误码

错误码	描述
111001	必填参数不能为空
111005	归档用户不可查询
116005	账号不存在

Demo

java

// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
// 创建请求对象
GetRelUserListRequest request = new GetRelUserListRequest();
request.setUserId("20251224INHERIT02");

BaseResponse response = client.execute(request);
//调用成功，则处理业务逻辑
if (response.isSuccess()) {
	//.....
}