人员信息
人员照片
描述
根据学工号查询照片
支持的模式
- 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"返回示例
json
{
"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"返回示例
json
{
"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"返回示例
json
{
"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"返回示例
json
{
"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 | 毕业论文题目 |
json
{
"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 | 在校状态 |
json
{
"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 | 是 | 证件号码 |
返回参数
| 参数名 | 类型 | 备注 |
|---|---|---|
| name | string | 姓名0 |
| userType | string | 身份 |
| userId | string | 学工号 |
请求示例
curl -H "Authorization: Bearer d6cf4b179889a558211ebb775b0239ed" "https://api.ecnu.edu.cn/api/v1/user/idsearch?userIzjhm=310****************"返回示例
json
{
"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/multisearch
请求参数
| 参数名 | 是否必填 | 备注 |
|---|---|---|
| userid | 是 | 学工号 |
返回参数
| 参数名 | 类型 | 备注 |
|---|---|---|
| userid | string | 学工号 |
| zjhm | string | 证件号码后六位 |
| department_id | string | 部门编号 |
| department | string | 部门名称 |
| active | string | 在校状态 |
| user_type | string | 人员类型 |
请求示例
curl -H "Authorization: Bearer d6cf4b179889a558211ebb775b0239ed" "https://api.ecnu.edu.cn/api/v1/user/multisearch?userid=**05"返回示例
json
{
"data": [{
"userId": "10******6",
"zjhm": "***12",
"departmentId": "015901",
"department": "计算机科学与技术学院",
"active": "0",
"user_type": "本科生"
}, {
"userId": "****05",
"zjhm": "***12",
"departmentId": "041601",
"department": "网络中心",
"active": "0",
"user_type": "教职工"
}, {
"userId": "****73",
"zjhm": "***12",
"departmentId": "0445",
"department": "信息化治理办公室",
"active": "1",
"user_type": "教职工"
}],
"errCode": 0,
"requestId": "7B2CB9E8-563C-48C4-88A5-BB93292CEB0D",
"errMsg": "success"
}