拉取机构
# 拉取机构
主动拉取服务：拉取服务是指第三方服务需要主动调用资源服务的接口，拉取信息，然后自行处理，拉取信息需要传递签名验签，签名需要在调用之前请求接口获取，此时用到了上面注册的appid和secret值
提示
《ip》 在 以下内容中代表的意思为 http://ip:port/urm/pull 例如: http://10.6.0.108/api/urm/pull
# 1、获取签名
调用服务之前需要获取签名信息，后续请求中在header头中需要传递该签名信息。
请求URL
《ip》/getAppSign
请求类型
POST
请求参数
| 属性 | 类型 | 描述 |
|---|---|---|
| appId | String | 资源服务中注册的唯一应用id |
| appSecret | String | 注册时的密钥 |
返回值
| 属性 | 类型 | 描述 |
|---|---|---|
| code | int | 状态码 成功200 失败500 |
| msg | String | 返回的消息，失败时传递失败原因 |
| data | Object | 响应体，返回的是appSign字符串，后续调用使用 |
示例
{
"msg": "获取成功",
"code": 200,
"data": "2c6f49f6f9bc7a55571d77d29d222afa"
}
1
2
3
4
5
2
3
4
5
# 2、拉取所有部门
调用服务之前需要获取签名信息，后续请求中在header头中需要传递该签名信息。
请求URL
《ip》/pullAllDepart
请求类型
GET
请求头
| 属性 | 类型 | 描述 |
|---|---|---|
| appSign | String | 是上面获取的签名值 |
请求参数
| 属性 | 类型 | 描述 |
|---|---|---|
| appId | String | 资源服务中注册的唯一应用id |
返回值
| 属性 | 类型 | 描述 |
|---|---|---|
| code | int | 状态码 成功200 失败500 |
| msg | String | 返回的消息，失败时传递失败原因 |
| data | Object | 响应体，返回的是机构的list列表数据 |
示例
{
"msg": "获取成功",
"code": 200,
"data": [
{
"address": null,
"administrativeDivision": null,
"cOrg": "1916374913804390401",
"children": null,
"createDate": "2025-04-27 14:12:38",
"createId": "6",
"createName": "赵鹏飞",
"departLevel": "1",
"departName": "烟草研究院",
"departOrder": 0,
"description": null,
"id": "1916374913804390402",
"isDel": 0,
"orgCode": null,
"orgType": "2",
"pOrg": "root",
"pOrgs": null,
"page": 1,
"poolId": "1916374866274537474",
"remark": null,
"rows": 10,
"sourceDepartId": null,
"updateDate": null,
"updateId": null,
"updateName": null
},
{
"address": "测试地址",
"administrativeDivision": null,
"cOrg": "1909080298640003074",
"children": null,
"createDate": "2025-04-27 14:12:53",
"createId": "6",
"createName": "赵鹏飞",
"departLevel": "1",
"departName": "局领导",
"departOrder": 1,
"description": null,
"id": "1916374976559566849",
"isDel": 0,
"orgCode": "058001",
"orgType": "1",
"pOrg": "1916374913804390401",
"pOrgs": null,
"page": 1,
"poolId": "1916374866274537474",
"remark": null,
"rows": 10,
"sourceDepartId": "1909080298640003073",
"updateDate": null,
"updateId": null,
"updateName": null
},
{
"address": "测试",
"administrativeDivision": null,
"cOrg": "1916374633629077505",
"children": null,
"createDate": "2025-04-27 14:12:53",
"createId": "6",
"createName": "赵鹏飞",
"departLevel": "1",
"departName": "研究院本部",
"departOrder": 2,
"description": null,
"id": "1916374976685395971",
"isDel": 0,
"orgCode": "yjybb",
"orgType": "2",
"pOrg": "1916374913804390401",
"pOrgs": null,
"page": 1,
"poolId": "1916374866274537474",
"remark": null,
"rows": 10,
"sourceDepartId": "1916374633629077506",
"updateDate": null,
"updateId": null,
"updateName": null
},
{
"address": "测试地址",
"administrativeDivision": null,
"cOrg": "1909080298640003076",
"children": null,
"createDate": "2025-04-27 14:12:53",
"createId": "6",
"createName": "赵鹏飞",
"departLevel": "1",
"departName": "局办公室",
"departOrder": 2,
"description": null,
"id": "1916374976559566850",
"isDel": 0,
"orgCode": "058002",
"orgType": null,
"pOrg": "1916374913804390401",
"pOrgs": null,
"page": 1,
"poolId": "1916374866274537474",
"remark": null,
"rows": 10,
"sourceDepartId": "1909080298640003075",
"updateDate": null,
"updateId": null,
"updateName": null
},
{
"address": "公司地址",
"administrativeDivision": null,
"cOrg": "1910141744006291459",
"children": null,
"createDate": "2025-04-27 14:12:53",
"createId": "6",
"createName": "赵鹏飞",
"departLevel": "1",
"departName": "技术支持部门",
"departOrder": 2,
"description": null,
"id": "1916374976622481410",
"isDel": 0,
"orgCode": "jszcbm",
"orgType": null,
"pOrg": "1916374913804390401",
"pOrgs": null,
"page": 1,
"poolId": "1916374866274537474",
"remark": null,
"rows": 10,
"sourceDepartId": "1910141744006291458",
"updateDate": null,
"updateId": null,
"updateName": null
},
{
"address": "测试地址",
"administrativeDivision": null,
"cOrg": "1909080298640003078",
"children": null,
"createDate": "2025-04-27 14:12:53",
"createId": "6",
"createName": "赵鹏飞",
"departLevel": "1",
"departName": "法规司",
"departOrder": 3,
"description": null,
"id": "1916374976622481409",
"isDel": 0,
"orgCode": "058003",
"orgType": null,
"pOrg": "1916374913804390401",
"pOrgs": null,
"page": 1,
"poolId": "1916374866274537474",
"remark": null,
"rows": 10,
"sourceDepartId": "1909080298640003077",
"updateDate": null,
"updateId": null,
"updateName": null
},
{
"address": null,
"administrativeDivision": null,
"cOrg": "1910141944267530242",
"children": null,
"createDate": "2025-04-27 14:12:53",
"createId": "6",
"createName": "赵鹏飞",
"departLevel": "1",
"departName": "技术科",
"departOrder": 10,
"description": null,
"id": "1916374976622481411",
"isDel": 0,
"orgCode": "jishu",
"orgType": null,
"pOrg": "1916374913804390401",
"pOrgs": null,
"page": 1,
"poolId": "1916374866274537474",
"remark": null,
"rows": 10,
"sourceDepartId": "1910141944267530241",
"updateDate": null,
"updateId": null,
"updateName": null
},
{
"address": null,
"administrativeDivision": null,
"cOrg": "1910144162102239234",
"children": null,
"createDate": "2025-04-27 14:12:53",
"createId": "6",
"createName": "赵鹏飞",
"departLevel": "1",
"departName": "运维办公室",
"departOrder": 11,
"description": null,
"id": "1916374976622481412",
"isDel": 0,
"orgCode": "yunwei",
"orgType": null,
"pOrg": "1910141744006291459",
"pOrgs": null,
"page": 1,
"poolId": "1916374866274537474",
"remark": null,
"rows": 10,
"sourceDepartId": "1910144162102239233",
"updateDate": null,
"updateId": null,
"updateName": null
},
{
"address": null,
"administrativeDivision": null,
"cOrg": "1911975140059684866",
"children": null,
"createDate": "2025-04-27 14:12:53",
"createId": "6",
"createName": "赵鹏飞",
"departLevel": "3",
"departName": "局科室1",
"departOrder": 1,
"description": null,
"id": "1916374976622481413",
"isDel": 0,
"orgCode": "jukeshi1",
"orgType": "1",
"pOrg": "1909080298640003074",
"pOrgs": null,
"page": 1,
"poolId": "1916374866274537474",
"remark": null,
"rows": 10,
"sourceDepartId": "1911975140059684867",
"updateDate": null,
"updateId": null,
"updateName": null
},
{
"address": null,
"administrativeDivision": null,
"cOrg": "1911975858942418945",
"children": null,
"createDate": "2025-04-27 14:12:53",
"createId": "6",
"createName": "赵鹏飞",
"departLevel": "3",
"departName": "局科室2",
"departOrder": 4,
"description": null,
"id": "1916374976685395970",
"isDel": 0,
"orgCode": "jukeshi2",
"orgType": "1",
"pOrg": "1911975140059684866",
"pOrgs": null,
"page": 1,
"poolId": "1916374866274537474",
"remark": null,
"rows": 10,
"sourceDepartId": "1911975858942418946",
"updateDate": null,
"updateId": null,
"updateName": 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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
# 3、拉取某个部门下的子部门:不递归
调用服务之前需要获取签名信息，后续请求中在header头中需要传递该签名信息。
请求URL
《ip》/pullDepartByPOrg
请求类型
POST 请求头
| 属性 | 类型 | 描述 |
|---|---|---|
| appSign | String | 是上面获取的签名值 |
请求参数
| 属性 | 类型 | 描述 |
|---|---|---|
| appId | String | 资源服务中注册的唯一应用id |
| pOrg | String | 父机构标识 |
返回值
| 属性 | 类型 | 描述 |
|---|---|---|
| code | int | 状态码 成功200 失败500 |
| msg | String | 返回的消息，失败时传递失败原因 |
| data | Object | 响应体，返回的机构list列表数据 |
示例
{
"msg": "获取成功",
"code": 200,
"data": [
{
"address": null,
"administrativeDivision": null,
"cOrg": "1911975858942418945",
"children": null,
"createDate": "2025-04-27 14:12:53",
"createId": "6",
"createName": "赵鹏飞",
"departLevel": "3",
"departName": "局科室2",
"departOrder": 4,
"description": null,
"id": "1916374976685395970",
"isDel": 0,
"orgCode": "jukeshi2",
"orgType": "1",
"pOrg": "1911975140059684866",
"pOrgs": null,
"page": 1,
"poolId": "1916374866274537474",
"remark": null,
"rows": 10,
"sourceDepartId": "1911975858942418946",
"updateDate": null,
"updateId": null,
"updateName": 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
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
# 4、拉取某个部门详情
调用服务之前需要获取签名信息，后续请求中在header头中需要传递该签名信息。
请求URL
《ip》/pullDepartById
请求类型
POST 请求头
| 属性 | 类型 | 描述 |
|---|---|---|
| appSign | String | 是上面获取的签名值 |
请求参数
| 属性 | 类型 | 描述 |
|---|---|---|
| appId | String | 资源服务中注册的唯一应用id |
| depId | String | 部门的id |
返回值
| 属性 | 类型 | 描述 |
|---|---|---|
| code | int | 状态码 成功200 失败500 |
| msg | String | 返回的消息，失败时传递失败原因 |
| data | Object | 响应体，部门的实体信息 |
示例
{
"msg": "获取成功",
"code": 200,
"data": {
"address": null,
"administrativeDivision": null,
"cOrg": "1911975858942418945",
"children": null,
"createDate": "2025-04-27 14:12:53",
"createId": "6",
"createName": "赵鹏飞",
"departLevel": "3",
"departName": "局科室2",
"departOrder": 4,
"description": null,
"id": "1916374976685395970",
"isDel": 0,
"orgCode": "jukeshi2",
"orgType": "1",
"pOrg": "1911975140059684866",
"pOrgs": null,
"page": 1,
"poolId": "1916374866274537474",
"remark": null,
"rows": 10,
"sourceDepartId": "1911975858942418946",
"updateDate": null,
"updateId": null,
"updateName": 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
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
# 5、部门的返回值信息代表的含义
private String id;
@ApiModelProperty(value="资源池id")
private String poolId;
@ApiModelProperty(value="源机构id")
private String sourceDepartId;
@ApiModelProperty(value = "机构名称")
private String departName;
@ApiModelProperty(value = "节点标识")
private String cOrg;
@ApiModelProperty(value = "父节点标识")
private String pOrg;
@ApiModelProperty(value = "描述")
private String description;
@ApiModelProperty(value = "父节点标识集")
private String pOrgs;
@ApiModelProperty(value = "机构编码")
private String orgCode;
@ApiModelProperty(value = "机构类型")
private String orgType;
@ApiModelProperty(value = "行政区划代码")
private String administrativeDivision;
@ApiModelProperty(value = "地址")
private String address;
@ApiModelProperty(value = "排序")
private Integer departOrder;
@ApiModelProperty(value = "机构级别")
private String departLevel;
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
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