# 教职工类APIs
本组API用于获取教职工相关信息。
- 使用本组API前请先阅读概述，令牌的获取参考此处，构造请求请参考此处，返回数据请参考此处，除非特殊注明，所有数据资源API有着通用的返回结构。
- 教职工类基于GraphQL协议老版本接口说明请参考此处。
# 申请
申请教职工类API接口，请通过数据资源申请 (opens new window)完成申请。
# 教工基本信息
- GET https://graphql.sjtu.edu.cn/v1/faculty/profile 客户端 exchange_data
# 请求参数
| 参数名 | 类型 | 必填 | 参数说明 |
|---|---|---|---|
| accountNo | string | 否 | jAccount账号 |
| gh | string | 否 | 工号 |
| topOrganizeId | string | 否 | 二级单位代码 |
| organizeId | string | 否 | 三级单位代码 |
| timestamp | string | 否 | 更新时间（yyyy-MM-dd/yyyy-MM-dd HH:mm:ss）,取大于等于该时间戳的数据 |
| first | int | 否 | 分页起始位置 分页参数说明 |
| offset | int | 否 | 分页偏移量 |
# 响应参数
所有数据资源API响应参数都有相同的通用结构
- 教工信息 Structure
{
"accountNo":{string} //jAccount
"displayName":{string} //姓名
"ryztm":{string} //人员状态代码
"ryztmc":{string} //人员状态名称
"gh":{string} //工号
"topOrganizeId":{string} //二级单位代码
"topOrganizeName":{string} //二级单位名称
"organizeId":{string} //三级单位代码
"organizeName":{string} //三级单位名称
"cardType":{string} //证件类别代码
"cardTypename":{string} //证件类别名称
"cardNo":{string} //证件号码
"telephone":{string} //电话号码
"email":{string} //邮箱
"xbm":{string} //性别代码（1：男性， 2：女性）
"xbmc":{string} //性别名称
"gjm":{string} //国籍代码
"gjmc":{string} //国籍名称
"mzm":{string} //民族代码
"mzmc":{string} //民族名称
"zzmmm":{string} //政治面貌代码
"zzmm":{string} //政治面貌名称
"hyzk":{string} //婚姻状况
"jgm":{string} //籍贯代码
"jg":{string} //籍贯名称
"csd":{string} //出生地代码
"csdmc":{string} //出生地名称
"csrq":{string} //出生日期
"hkszd":{string} //户口所在地代码
"hkszdmc":{string} //户口所在地名称
"gzny":{string} //工作年月
"jzglbm":{string} //教职工类别代码
"jzglbmc":{string} //教职工类别名称
"rylbm":{string} //人员类别代码
"rylbmc":{string} //人员类别名称
"bzm":{string} //编制代码
"bzmc":{string} //编制名称
"sxzym":{string} //所学专业代码
"sxzymc":{string} //所学专业名称
"cszym":{string} //从事专业代码
"cszymc":{string} //从事专业名称
"gwm":{string} //岗位代码
"gwmc":{string} //岗位名称
"zjm":{string} //职级代码
"zjmc":{string} //职级名称
"yjfx":{string} //研究方向
"lxny":{string} //来校年月
"lxrq":{string} //离校日期
"ltxny":{string} //离退休年月
"lxlbm":{string} //离校类别代码
"ltxlbmc":{string} //离校类别名称
"przwm":{string} //聘任职务代码
"pdny":{string} //评定年月
"przwmc":{string} //聘任职务名称
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
# 请求示例
GET /v1/faculty/profile?access_token=token HTTP/1.1
Host: graphql.sjtu.edu.cn
accountNo=zhangsan&first=1&offset=10
1
2
3
4
2
3
4
# 响应示例
示例 成功返回的数据
HTTP/1.1 200
Content-Type: application/json;charset=UTF-8
{
"errno": 0,
"error": null,
"total": 1,
"entities": [{
"accountNo": "zhangsan",
"displayName": "张三",
"ryztm": "9",
"ryztmc": "在职",
"gh": "xxxxx",
"topOrganizeId": "01000",
"topOrganizeName": "船舶海洋与建筑工程学院",
"organizeId": "01001",
"organizeName": "船院党政综合办公室",
"cardType": "01",
"cardTypename": "身份证",
"cardNo": "31011119920311xxxx",
"telephone": "12800000000",
"email": "zhangsan@sjtu.edu.cn",
"xbm": "1",
"xbmc": "男性",
"gjm": "CN",
"gjmc": "中国",
"mzm": "01",
"mzmc": "汉族",
"zzmmm": "13",
"zzmm": "群众",
"hyzk": "已婚",
"jgm": null,
"jg": null,
"csd": null,
"csdmc": null,
"csrq": "1992.03.11",
"hkszd": "310226",
"hkszdmc": null,
"gzny": null,
"jzglbm": "116",
"rylbmc": "支撑队伍",
"rylbm": "111",
"rylbmc": "劳动聘用",
"bzm": "40 ",
"bzmc": "教辅类",
"sxzym": null,
"sxzymc": null,
"cszym": "130500",
"cszymc": "设计学",
"gwm": "43 ",
"gwmc": "工程",
"zjm": "9 ",
"zjmc": "未评",
"yjfx": "",
"lxny": "2018.07",
"lxrq": null,
"ltxny": null,
"lxlbm": null,
"ltxlbmc": null,
"przwm": null,
"pdny": null,
"przwmc": null
}]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
- ryztm人员状态列表 Data
| Value | Description |
|---|---|
| 9 | 在职 |
| 4 | 离职 |
| 3 | 死亡 |
| 2 | 离退休 |
# 教工学位信息
- GET https://graphql.sjtu.edu.cn/v1/faculty/degree 客户端 exchange_data
# 请求参数
| 参数名 | 类型 | 必填 | 参数说明 |
|---|---|---|---|
| gh | string | 否 | 工号 |
| topOrganizeId | string | 否 | 二级单位代码 |
| organizeId | string | 否 | 三级单位代码 |
| timestamp | string | 否 | 更新时间（yyyy-MM-dd/yyyy-MM-dd HH:mm:ss）,取大于等于该时间戳的数据 |
| first | int | 否 | 分页起始位置 |
| offset | string | 否 | 分页偏移量 |
# 响应参数
所有数据资源API响应参数都有相同的通用结构
- 学位信息 Structure
{
"gh":{string} //工号
"xh":{int} //序号
"topOrganizeId":{string} //二级单位代码
"topOrganizeName":{string} //二级单位名称
"organizeId":{string} //三级单位代码
"organizeName":{string} //三级单位名称
"byxx":{string} //毕业学校
"sxzym":{string} //所学专业代码
"sxzymc":{string} //所学专业名称
"rxny":{string} //入学年月
"byny":{string} //毕业年月
"xz":{float} //学制
"xlm":{string} //学历代码
"xlmc":{string} //学历名称
"xwm":{string} //学位代码
"xwmc":{string} //学位名称
"hxwny":{string} //获学位年月
"sxwdw":{string} //授学位单位
"sxwgm":{string} //授学位国别代码
"sxwgmc":{string} //授学位国别名称
"dwsxm":{string} //毕业单位属性代码
"dwsxmc":{string} //毕业单位属性名称
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# 请求示例
GET /v1/faculty/degree?access_token=token HTTP/1.1
Host: graphql.sjtu.edu.cn
gh=99999&first=1&offset=200
1
2
3
4
2
3
4
# 响应示例
示例 成功返回的数据
HTTP/1.1 200
Content-Type: application/json;charset=UTF-8
{
"errno": 0,
"error": null,
"total": 1,
"entities": [{
"gh": "99999",
"xh": "1",
"topOrganizeId": "01000",
"topOrganizeName": "船舶海洋与建筑工程学院",
"organizeId": "01001",
"organizeName": "船院党政综合办公室",
"byxx": "上海交通大学",
"sxzym": "082401",
"sxzymc": "船舶与海洋结构物设计制造",
"rxny": "2001.09",
"byny": "2004.03",
"xz": 3,
"xlm": "14",
"xlmc": "硕士研究生毕业",
"xwm": "308",
"xwmc": "工学硕士",
"hxwny": "2004.03",
"sxwdw": "上海交通大学",
"sxwgm": "CN",
"sxwgmc": "中国",
"dwsxm": "14",
"dwsxmc": "全日制高等学校"
}]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# 教工党政职务信息
- GET https://graphql.sjtu.edu.cn/v1/faculty/post 客户端 exchange_data
# 请求参数
| 参数名 | 类型 | 必填 | 参数说明 |
|---|---|---|---|
| gh | string | 否 | 工号 |
| topOrganizeId | string | 否 | 二级单位代码 |
| organizeId | string | 否 | 三级单位代码 |
| timestamp | string | 否 | 更新时间（yyyy-MM-dd/yyyy-MM-dd HH:mm:ss）,取大于等于该时间戳的数据 |
| first | int | 否 | 分页起始位置 |
| offset | string | 否 | 分页偏移量 |
# 响应参数
所有数据资源API响应参数都有相同的通用结构
- 党政职务信息 Structure
{
"gh":{string} //工号
"xh":{int} //序号
"topOrganizeId":{string} //二级单位代码
"topOrganizeName":{string} //二级单位名称
"organizeId":{string} //三级单位代码
"organizeName":{string} //三级单位名称
"dzzw":{string} //党政职务
"zwjbm":{string} //职务级别代码
"zwjbmc":{string} //职务级别名称
"dqrzzk":{string} //当前任职状况
"rzdm":{string} //校内任职部门
"rzwh":{float} //任职文号
"rzny":{string} //任职年月
"rzpzdw":{string} //任职批准单位
"dwjb":{string} //单位级别
"jbny":{string} //评定职务级别年月
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 请求示例
GET /v1/faculty/post?access_token=token HTTP/1.1
Host: graphql.sjtu.edu.cn
gh=99999&first=1&offset=200
1
2
3
4
2
3
4
# 响应示例
示例 成功返回的数据
HTTP/1.1 200
Content-Type: application/json;charset=UTF-8
{
"errno": 0,
"error": null,
"total": 1,
"entities": [{
"gh": "99999",
"xh": "1",
"topOrganizeId": "01000",
"topOrganizeName": "船舶海洋与建筑工程学院",
"organizeId": "01001",
"organizeName": "船院党政综合办公室",
"dzzw": "船舶海洋与建筑工程学院副院长",
"zwjbm": "3",
"zwjbmc": "正处级",
"dqrzzk": "Y",
"rzdm": "01000",
"rzwh": "沪交组[2020]xxx号",
"rzny": "2020.01",
"rzpzdw": "上海交通大学",
"dwjb": null,
"jbny": "2022.01"
}]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26