人员信息
人员照片
描述
根据学工号查询照片
支持的模式
- authorization_code
- client_credentials
- password
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/user/photo
请求参数
参数名 | 是否必填 | 备注 |
---|---|---|
userId | 是 | 用户名,即学工号,当授权为authorization_code和password模式时可省略 |
返回参数
返回 Content-Type: image/jpeg
的图片
请求示例
curl -H "Authorization: Bearer d6cf4b179889a558211ebb775b0239ed" "https://api.ecnu.edu.cn/api/v1/user/photo?userId=20****73" > photo.jpeg
返回示例
无
人员基本信息
描述
根据学工号查询基本信息,本接口只返回在校状态的用户
支持的模式
- authorization_code
- client_credentials
- password
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/user/info
请求参数
参数名 | 是否必填 | 备注 |
---|---|---|
userId | 是 | 用户名,即学工号,当授权为authorization_code和password模式时可省略 |
返回参数
参数名 | 类型 | 备注 |
---|---|---|
userType | string | 身份类型 |
departmentId | string | 部门编号 |
department | string | 部门名称 |
name | string | 姓名 |
userId | string | 学工号 |
active | string | 在校状态,0不在小1在校 |
请求示例
curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/user/info?userId=20****73"
返回示例
{
"data": [
{
"departmentId": "0445",
"active": "1",
"userType": "教职工",
"department": "信息化治理办公室",
"userId": "20****073",
"name": "**"
}
],
"errCode": 0,
"requestId": "0bc14a6a16536526237268330e29d9",
"errMsg": "success",
"apiLog": null
}
人员证件信息
描述
根据学工号查询身份证号码和证件类型。
由于证件信息属于个人敏感数据。此接口虽然技术上支持 client_credentials
,但原则上只允许使用 authorization_code
模式,在用户授权许可的前提下获取,且必须以签报或其他书面形式的方式申请。
支持的模式
- authorization_code
- client_credentials
- password
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/user/sensitive/zj
请求参数
参数名 | 是否必填 | 备注 |
---|---|---|
userId | 是 | 用户名,即学工号,当授权为authorization_code和password模式时可省略 |
返回参数
参数名 | 类型 | 备注 |
---|---|---|
zjlx | string | 证件类型 |
zjhm | string | 证件号码 |
userId | string | 学工号 |
请求示例
curl -H "Authorization: Bearer d6cf4b179889a558211ebb775b0239ed" "https://api.ecnu.edu.cn/api/v1/user/sensitive/zj?userId=20****73"
返回示例
{
"data": [
{
"zjlx": "居民身份证",
"zjhm": "310*************",
"userId": "20******3"
}
],
"errCode": 0,
"requestId": "65841fdd16242692437062235e62ab",
"errMsg": "success",
"apiLog": null
}
教职工基本信息
描述
根据职工号查询教职工基本信息
支持的模式
- authorization_code
- client_credentials
- password
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/user/profile/staff
请求参数
参数名 | 是否必填 | 备注 |
---|---|---|
userId | 是 | 用户名,即学工号,当授权为authorization_code和password模式时可省略 |
返回参数
参数名 | 类型 | 备注 |
---|---|---|
userId | string | 职工号 |
name | string | 姓名 |
departmentId | string | 部门代码 |
sexId | string | 性别代码 |
sex | string | 性别 |
string | 邮箱 | |
status | string | 在校状态代码 |
statusname | string | 在校状态名称 |
joinDate | string | 入职年月 |
birthday | string | 出生年月 |
technicCode | string | 职称代码 |
technicName | string | 职称 |
techLevel | string | 职称级别代码 |
techLevelName | string | 职称级别 |
techStartDate | string | 职称开始时间 |
post | object array | 岗位,可能有多个 |
postSort | string | 岗位类型代码 |
postSortName | string | 岗位类型 |
postLevel | string | 岗位级别代码 |
postLevelName | string | 岗位级别名称 |
postStartDate | string | 岗位开始时间 |
startDate | string | 聘期开始时间 |
endDate | string | 聘期结束时间 |
请求示例
curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/user/profile/staff?userId=20****73"
返回示例
{
"errCode": 0,
"errMsg": "success",
"requestId": "ff030688-979b-4e42-9b11-3232243c0263",
"data": [{
"userId": "20**73",
"name": "冯*",
"departmentId": "0*5",
"department": "***公室",
"sexId": "1",
"sex": "男性",
"mail": "***@admin.ecnu.edu.cn",
"status": "on",
"statusName": "在职",
"birthday": "1989-06-19",
"joinDate": "2015-08-01",
"technicCode": "082",
"technicName": "高级工程师",
"techLevel": "2",
"techLevelName": "副高",
"techStartDate": "",
"post": [{
"postSort": "01",
"postSortName": "专业技术岗位",
"postLevel": "0107",
"postLevelName": "副高三级",
"postStartDate": "2021-12-31"
}],
"startDate": "2018-08-01",
"endDate": "2021-07-31"
}]
}
学生基本信息
描述
根据学工号查询学生基本信息,已经整合研究生和本科生的相关数据
支持的模式
- authorization_code
- client_credentials
- password
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/user/profile/student
请求参数
参数名 | 是否必填 | 备注 |
---|---|---|
userId | 是 | 用户名,即学工号,当授权为authorization_code和password模式时可省略 |
返回参数
参数名 | 类型 | 备注 |
---|---|---|
userId | string | 学号 |
xm | string | 姓名 |
departmentId | string | 院系代码,研究生指二级培养单位,本科指专业院系 |
departmentName | string | 院系名称,研究生指二级培养单位,本科指专业院系 |
parentDepartmentId | string | 上级部门代码,研究生指一级培养单位,本科指管理院系 |
parentDepartmentName | string | 上级部门名称,研究生指一级培养单位,本科指管理院系 |
classNo | string | 班级号 |
className | string | 班级名称 |
xz | string | 学制 |
zydm | string | 专业代码 |
zymc | string | 专业名称 |
zzmmm | string | 政治面貌码 |
userType | string | 学生类型 |
xq | string | 校区 |
sfzx | string | 是否在校 |
startTime | string | 入学时间 |
endTime | string | 离校(毕业)或预计离校(毕业)时间 |
active | string | 在校状态,0不在小1在校 |
xwlb | string | 学位类别 |
xxxs | string | 学习形式 |
请求示例
curl -i -H "Authorization: Bearer 6e386d972af223a36865dea0617eb87e" "https://api.ecnu.edu.cn/api/v1/user/profile/student?userId=10****30"
返回示例
{
"data": [{
"userId":"10****30",
"xm":"李*",
"departmentId":"015401",
"departmentName":"汉语言系",
"parentDepartmentId":"015401",
"parentDepartmentName":"汉语言系",
"xbm":"1",
"nj":"2007",
"xz":"4",
"zydm":"2720",
"zymc":"汉语言",
"zzmmm":"",
"userType":"本科生",
"xq":"闵行校区",
"sfzx":"0",
"xwlb": "本科",
"xxxs": "普通全日制"
}],
"errCode": 0,
"requestId": "65841f9216339166750905704e49ab",
"errMsg": "success",
"apiLog": null
}
本科生基本信息
描述
根据学号查询本科生基本信息
支持的模式
- authorization_code
- client_credentials
- password
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/user/profile/bks
请求参数
参数名 | 是否必填 | 备注 |
---|---|---|
userId | 是 | 用户名,即学工号,当授权为authorization_code和password模式时可省略 |
返回参数
参数名 | 类型 | 备注 |
---|---|---|
xbm | string | 性别代码 |
xz | string | 学制 |
xxxs | string | 学习形式代码 |
zyh | string | 专业号 |
xslb | string | 学生类别 |
xxxsmc | string | 学习形式名称 |
sfmsm | string | 是否免收费,1是0否 |
normal | string | 是否师范生,1是0否 |
xslbId | string | 学生类别代码 |
rxny | string | 入校年月 |
sfzx | string | 是否在校,1在0不在 |
zyyx | string | 专业院系 |
userId | string | 用户名,即学号 |
bdrq | string | 入学报到日期 |
xh | string | 学号 |
bjmc | string | 班级名称 |
glyx | string | 管理院系 |
xm | string | 姓名 |
glyxm | string | 管理院系代码 |
lxrq | string | 离校日期 |
xq | string | 校区 |
nj | string | 年级 |
zy | string | 专业 |
zyyxm | string | 专业院系代码 |
dsgh | string | 论文指导老师工号 |
dsxm | string | 论文指导老师姓名 |
lw | string | 毕业论文题目 |
{
"data": [
{
"xbm": "1",
"xz": "4",
"xxxs": "3",
"zyh": "5102",
"xslb": "统招生",
"xxxsmc": "普通全日制",
"sfmsm": "0",
"normal": "0",
"xslbId": "15",
"rxny": "2007-09-01",
"sfzx": "0",
"zyyx": "计算机科学与技术学院",
"userId": "10*****36",
"bdrq": "2007-09-01",
"xh": "10*******36",
"bjmc": "本科07级计算机科学与技术专业02班",
"glyx": "计算机科学与技术学院",
"xm": "****",
"glyxm": "015901",
"lxrq": "2011-09-01",
"xq": "闵行校区",
"nj": "2007",
"zy": "计算机科学与技术",
"zyyxm": "015901",
"dsgh":"2******1",
"dsxm": "***",
"lw": "***"
}
],
"requestId": "6a0f0ef016225969735311558e4bc8",
"errCode": 0,
"errMsg": "success",
"apiLog": null
}
研究生基本信息
描述
根据学号查询研究生基本信息
支持的模式
- authorization_code
- client_credentials
- password
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/user/profile/yjs
请求参数
参数名 | 是否必填 | 备注 |
---|---|---|
userId | 是 | 用户名,即学工号,当授权为authorization_code和password模式时可省略 |
返回参数
参数名 | 类型 | 备注 |
---|---|---|
cc | string | 层次,硕士研究生或博士研究生 |
xz | string | 学制 |
xbm | string | 性别代码 |
lqlb | string | 录取类别 |
dsxm | string | 导师姓名 |
zymc | string | 专业名称 |
yxmc | string | 院系名称 |
userId | string | 用户名,即学号 |
rxrq | string | 入学日期 |
xh | string | 学号 |
yxdm | string | 院系代码 |
zydm | string | 专业代码 |
lqlbdm | string | 录取类别代码 |
xwlx | string | 学位类型 |
xm | string | 姓名 |
yjbyrq | string | 预计毕业日期 |
nj | string | 年级 |
dsgh | string | 导师工号 |
sfzx | string | 是否在校,1在0不在 |
xxxs | string | 学习形式 |
zxjh | string | 专项计划 |
xq | string | 校区 |
zxzt | string | 在校状态 |
{
"data": [{
"cc": "硕士研究生",
"xz": "2.5",
"xbm": "1",
"xxxs": "全日制",
"sfzx": "1",
"zxjh": "硕士_无专项计划",
"lqlb": "非定向",
"dsxm": "沈*",
"zymc": "计算机技术",
"yxmc": "计算机科学与技术学院",
"userId": "51****70",
"rxrq": "2019-09-01",
"xh": "51*****70",
"yxdm": "015901",
"zydm": "085211",
"lqlbdm": "11",
"xwlx": "专业学位",
"xm": "胡**",
"yjbyrq": "2022-01-01",
"nj": "2019",
"dsgh": "1****22",
"xq": "闵行校区",
"zxzt": "在校"
}],
"requestId": "6a0f0ef016310997936994349e6875",
"errCode": 0,
"errMsg": "success",
"apiLog": null
}
使用证件号码查询用户
描述
使用证件号码查询用户信息
支持的模式
- client_credentials
- password
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/user/idsearch
请求参数
参数名 | 是否必填 | 备注 |
---|---|---|
zjhm | 是 | 证件号码 |
返回参数
参数名 | 类型 | 备注 |
---|---|---|
zjlx | string | 证件类型 |
zjhm | string | 证件号码 |
userId | string | 学工号 |
返回参数
参数名 | 类型 | 备注 |
---|---|---|
name | string | 姓名0 |
userType | string | 身份 |
userId | string | 学工号 |
请求示例
curl -H "Authorization: Bearer d6cf4b179889a558211ebb775b0239ed" "https://api.ecnu.edu.cn/api/v1/user/idsearch?userIzjhm=310****************"
返回示例
{
"data": [
{
"name": "冯*",
"userType": "教职工",
"userId": "20******73"
}
],
"requestId": "65841f9216242869679953747e2406",
"errCode": 0,
"errMsg": "success",
"apiLog": null
}
使用学工号查询岗位
描述
根据学工号查询身份治理平台岗位信息
支持的模式
- client_credentials
- password
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/user/position
请求参数
参数名 | 是否必填 | 备注 |
---|---|---|
userId | 是 | 学工号 |
返回参数
参数名 | 类型 | 备注 |
---|---|---|
userId | string | 学工号 |
userName | string | 姓名 |
deptCode | string | 部门编号 |
deptName | string | 部门名称 |
positionCode | string | 岗位编号 |
positionName | string | 岗位名称 |
请求示例
curl -H "Authorization: Bearer d6cf4b179889a558211ebb775b0239ed" "https://api.ecnu.edu.cn/api/v1/user/position?userId=201****68"
返回示例
{
"data": [
{
"userId": "201****68",
"userName": "王**",
"deptCode": "0445",
"deptName": "信息化治理办公室",
"positionCode": "02000000",
"positionName": "教职工"
},
{
"userId": "201****68",
"userName": "王**",
"deptCode": "0445",
"deptName": "信息化治理办公室",
"positionCode": "GL-POST-SSOJC00002",
"positionName": "统一身份认证集成申请_信息办预审"
},
{
"userId": "201****68",
"userName": "王**",
"deptCode": "0445",
"deptName": "信息化治理办公室",
"positionCode": "GL-POST-RHMHJSCKB",
"positionName": "数智治理驾驶舱专题看板"
},
{
"userId": "201****68",
"userName": "王**",
"deptCode": "0445",
"deptName": "信息化治理办公室",
"positionCode": "GL-POST-LWRYGLXT00001",
"positionName": "丽娃人员管理系统"
},
{
"userId": "201****68",
"userName": "王**",
"deptCode": "0445",
"deptName": "信息化治理办公室",
"positionCode": "Infoplus_Developer",
"positionName": "流程引擎_开发者"
},
{
"userId": "201****68",
"userName": "王**",
"deptCode": "0445",
"deptName": "信息化治理办公室",
"positionCode": "PostAdmin",
"positionName": "岗位管理员"
},
{
"userId": "201****68",
"userName": "王**",
"deptCode": "0445",
"deptName": "信息化治理办公室",
"positionCode": "GL-POST-RHMHGJZBZLPT",
"positionName": "关键指标治理平台"
}
],
"errCode": 0,
"requestId": "ced8a45ec98aa7f7a61fb55ea9d90a91",
"errMsg": "success"
}
使用岗位代码查询该岗位下所有人员
描述
根据身份治理平台中岗位代码查询该岗位下所有人员
支持的模式
- client_credentials
- password
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/user/positionusers
请求参数
参数名 | 是否必填 | 备注 |
---|---|---|
positionCode | 是 | 岗位code |
返回参数
参数名 | 类型 | 备注 |
---|---|---|
userId | string | 学工号 |
userName | string | 姓名 |
deptCode | string | 部门编号 |
deptName | string | 部门名称 |
positionCode | string | 岗位编号 |
positionName | string | 岗位名称 |
请求示例
curl -H "Authorization: Bearer d6cf4b179889a558211ebb775b0239ed" "https://api.ecnu.edu.cn/api/v1/user/positionusers?positionCode=yy_post_gonghuizhuxi"
返回示例
{
"data": [
{
"userId": "20****36",
"userName": "韩*",
"deptCode": "012901",
"deptName": "中国语言文学系",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****06",
"userName": "张*",
"deptCode": "012902",
"deptName": "历史学系",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****66",
"userName": "王**",
"deptCode": "012903",
"deptName": "哲学系",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****22",
"userName": "何*",
"deptCode": "012905",
"deptName": "政治学系(人文社会科学学院)",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****06",
"userName": "郑*",
"deptCode": "0146",
"deptName": "法学院",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "19****31",
"userName": "龚**",
"deptCode": "0142",
"deptName": "马克思主义学院",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "19****02",
"userName": "邝**",
"deptCode": "013501",
"deptName": "社会学系",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****67",
"userName": "苏**",
"deptCode": "010403",
"deptName": "大学英语教学部",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "19****55",
"userName": "肖*",
"deptCode": "015401",
"deptName": "汉语言系",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "19****54",
"userName": "王*",
"deptCode": "0141",
"deptName": "教育学部",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "19****42",
"userName": "刘**",
"deptCode": "0132",
"deptName": "心理与认知科学学院",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****93",
"userName": "李**",
"deptCode": "011004",
"deptName": "运动训练系",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****88",
"userName": "欧阳**",
"deptCode": "014401",
"deptName": "经济学院",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****56",
"userName": "仇**",
"deptCode": "014404",
"deptName": "统计学院",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****67",
"userName": "余**",
"deptCode": "014403",
"deptName": "公共管理学院",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****30",
"userName": "巩**",
"deptCode": "012301",
"deptName": "广播电视学系",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****06",
"userName": "王**",
"deptCode": "0156",
"deptName": "音乐学院",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****35",
"userName": "马**",
"deptCode": "0150",
"deptName": "美术学院",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****47",
"userName": "王**",
"deptCode": "0138",
"deptName": "孟宪承书院",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****42",
"userName": "汪**",
"deptCode": "0155",
"deptName": "数学科学学院",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "19****45",
"userName": "赵**",
"deptCode": "014702",
"deptName": "物理学系",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****17",
"userName": "王**",
"deptCode": "0143",
"deptName": "化学与分子工程学院",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****82",
"userName": "蒋**",
"deptCode": "013902",
"deptName": "城市与区域科学学院",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****48",
"userName": "路*",
"deptCode": "013903",
"deptName": "生态与环境科学学院",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "19****05",
"userName": "倪*",
"deptCode": "011300",
"deptName": "生命科学学院办公室",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****71",
"userName": "李**",
"deptCode": "01590401",
"deptName": "通信与电子工程学院办公室",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****89",
"userName": "谢**",
"deptCode": "015901",
"deptName": "计算机科学与技术学院",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****39",
"userName": "赵*",
"deptCode": "015902",
"deptName": "软件工程学院",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****18",
"userName": "张*",
"deptCode": "015903",
"deptName": "数据科学与工程学院",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****35",
"userName": "袁*",
"deptCode": "013904",
"deptName": "河口海岸科学研究院(海洋科学学院)",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****43",
"userName": "童**",
"deptCode": "0303",
"deptName": "党委组织部",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****34",
"userName": "罗*",
"deptCode": "0431",
"deptName": "后勤保障部",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "19****51",
"userName": "严*",
"deptCode": "0203",
"deptName": "图书馆",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****74",
"userName": "董*",
"deptCode": "0132",
"deptName": "心理与认知科学学院",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****15",
"userName": "宛*",
"deptCode": "0140",
"deptName": "国家教育宏观政策研究院",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****86",
"userName": "张**",
"deptCode": "1001",
"deptName": "第二附属中学",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****15",
"userName": "周*",
"deptCode": "0308",
"deptName": "工会",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
},
{
"userId": "20****97",
"userName": "朱**",
"deptCode": "0308",
"deptName": "工会",
"positionCode": "yy_post_gonghuizhuxi",
"positionName": "部门工会主席"
}
],
"errCode": 0,
"requestId": "ac0322fce6fbb0a4eb25246514fceb5c",
"errMsg": "success"
}