更新 '接口文档'

刘行 2021-03-12 18:24:58 +08:00
parent 62913e3337
commit 360ccf6a46

@ -29,8 +29,8 @@
~~~json ~~~json
{ {
"phone": "用户电话号码", "phone": "cveo",
"password": "密码" "password": "cveo123456"
} }
~~~ ~~~
@ -38,38 +38,28 @@
~~~json ~~~json
{ {
"code": "状态码", "code": 0,
"msg": "提示信息", "msg": "请求成功!",
"data": { "data": {
"token": "token字符串", "token": "8f6b21a0-fa4b-4241-b5f7-58355048e1f9",
"username": "用户名", "username": "cveo",
"idNumber": "身份证号", "idNumber": "",
"administrativeArea": { "phone": "cveo",
"province": "XX省", "roleSet": [
"city": "XX市",
"county": "XX区"
},
"roleList": [ //角色列表
"XXX角色",
"XX角色"
],
"departmentList": [ //部门列表
{ {
"id": "xxxxxxxx", "name": "管理员",
"name": "XXX部门", "authoritySet": [
"parent": "上级部门id", //若无上级部门则此字段为null "管理员"
"children": [] //下级部门列表
},
{
"id": "xxxxxxxx",
"name": "XXX部门",
"parent": "上级部门id", //若无上级部门则此字段为null
"children": [] //下级部门列表
},
...
] ]
} }
],
"departmentList": [],
"administrativeArea": null
} }
}
Response code: 200; Time: 923ms; Content length: 224 bytes
~~~ ~~~
- -
@ -88,11 +78,9 @@
~~~json ~~~json
{ {
"phone": "用户电话号码", "phone": "13995833300",
"roleList":[ //新的角色列表 "roleSet": [
"管理员", "测试角色"
"流调人员",
...
] ]
} }
~~~ ~~~
@ -138,9 +126,13 @@
{ {
"username": "用户名", "username": "用户名",
"phone": "电话号码", "phone": "电话号码",
"roleList": [ "roleSet": [
"XXX角色", {
"XX角色" "name":"XXX",
"authoritySet":[
"XXX权限"
]
}
], ],
"departmentList": [ "departmentList": [
@ -155,7 +147,7 @@
### 4、删除用户 ### 4、管理员删除用户
- url`/user/user` - url`/user/user`
@ -195,13 +187,13 @@
~~~json ~~~json
{ {
"phone": "用户电话号码", "phone": "13995833308",
"username": "用户名", "username": "Pope8",
"idNumber": "身份证号", "idNumber": "4207042000022700118",
"administrativeArea": { "administrativeArea": {
"province": "XX省", "province": "湖北省",
"city": "XX市", "city": "鄂州市",
"county": "XX区" "county": "鄂城区"
} }
} }
~~~ ~~~
@ -258,14 +250,14 @@
~~~json ~~~json
{ {
"idNumber": "身份证号", "idNumber": "4207042000227001X",
"username": "用户名", "username": "Pope10",
"phone": "手机号", "phone": "1399583330X",
"password": "密码", "password": "13995833308",
"administrativeArea": { "administrativeArea": {
"province": "XX省", "province": "湖北省",
"city": "XX市", "city": "鄂州市",
"county": "XX区" "county": "鄂城区"
} }
} }
~~~ ~~~
@ -300,11 +292,10 @@
~~~json ~~~json
{ {
"roleName": "新角色名", "name": "新角色名",
"authorityList": [ //权限列表 "authoritySet": [ //权限列表
"XXX权限", "XXX权限",
"XXXX权限", "XXXX权限"
...
] ]
} }
~~~ ~~~
@ -333,7 +324,7 @@
| :---------: | :------: | :------: | :---------------: | | :---------: | :------: | :------: | :---------------: |
| pageSize | 是 | int | 页大小默认30 | | pageSize | 是 | int | 页大小默认30 |
| currentPage | | int | 当前页数从0开始 | | currentPage | | int | 当前页数从0开始 |
| roleName | 是 | String | 权限名模糊匹配 | | name | 是 | String | 权限名模糊匹配 |
- 返回数据 - 返回数据
@ -347,8 +338,8 @@
"currentPage": 0, "currentPage": 0,
"data": [ "data": [
{ {
"roleName": "流调人员", "name": "流调人员",
"authList": [ "authoritySet": [
"查询调查记录的权限", "查询调查记录的权限",
"修改调查记录权限", "修改调查记录权限",
"分析调查记录权限", "分析调查记录权限",
@ -358,12 +349,6 @@
"查询流调人员信息的权限", "查询流调人员信息的权限",
"查询调查对象信息的权限" "查询调查对象信息的权限"
] ]
},
{
"roleName": "管理员",
"authList": [
"管理员"
]
} }
] ]
} }
@ -384,7 +369,7 @@
~~~json ~~~json
{ {
"roleName": "XXX角色" "name": "XXX角色"
} }
~~~ ~~~
@ -412,8 +397,8 @@
~~~json ~~~json
{ {
"roleName": "XXX角色", "name": "XXX角色",
"authorityList": [ "authoritySet": [
"XXX权限", "XXX权限",
"XX权限" "XX权限"
] ]
@ -486,7 +471,10 @@
"province": "XX省", "province": "XX省",
"city": "XX市", "city": "XX市",
"county": "XX区" "county": "XX区"
} },
"projectSet": [
"XX项目"
]
} }
~~~ ~~~
@ -511,12 +499,12 @@
| 参数名 | 是否可选 | 参数类型 | 参数说明 | | 参数名 | 是否可选 | 参数类型 | 参数说明 |
| :---------: | :------: | :------: | :------------------: | | :---------: | :------: | :------: | :------------------: |
| userPhone | | String | 分配的用户的电话号码 | | userPhone | | String | 分配的用户的电话号码 |
| state | 是 | String | 已调查/待调查 | | state | 是 | String | 已调查/待调查 |
| province | 是 | String | 行政区划省份 | | province | 是 | String | 行政区划省份 |
| city | 是 | String | 行政区划城市 | | city | 是 | String | 行政区划城市 |
| county | 是 | String | 行政区划区县 | | county | 是 | String | 行政区划区县 |
| currentPage | 是 | int | 当前页数默认为0 | | currentPage | | int | 当前页数从0开始 |
| pageSize | 是 | int | 当前页大小默认为30 | | pageSize | 是 | int | 当前页大小默认为30 |
- 返回数据 - 返回数据
@ -537,7 +525,7 @@
"msg": "备注", "msg": "备注",
"userInfo": { //分配给的用户的信息 "userInfo": { //分配给的用户的信息
"idNumber": "身份证号", "idNumber": "身份证号",
"name": "姓名", "username": "姓名",
"phone": "电话号码" "phone": "电话号码"
}, },
"gender": "男/女", "gender": "男/女",
@ -545,7 +533,10 @@
"province": "XX省", "province": "XX省",
"city": "XX市", "city": "XX市",
"county": "XX区" "county": "XX区"
} },
"projectSet":[
"XXX项目"
]
} }
] ]
} }
@ -576,7 +567,10 @@
"province": "XX省", "province": "XX省",
"city": "XX市", "city": "XX市",
"county": "XX区" "county": "XX区"
} },
"projectSet": [
"XXX项目"
]
} }
~~~ ~~~
@ -626,7 +620,7 @@
### 1、查询调查记录 ### 1、查询调查记录
- url`/investigationRecord/investigationRecord` - url`/record/record`
- method`GET` - method`GET`
@ -639,7 +633,7 @@
| idNumber | 是 | String | 调查对象的身份证号 | | idNumber | 是 | String | 调查对象的身份证号 |
| version | 是 | String | 调查记录版本 | | version | 是 | String | 调查记录版本 |
| questionnaireNumber | 是 | String | 调查记录问卷编号 | | questionnaireNumber | 是 | String | 调查记录问卷编号 |
| currentPage | 是 | int | 当前页数默认为0 | | currentPage | | int | 当前页数从0开始 |
| pageSize | 是 | int | 页大小默认为30 | | pageSize | 是 | int | 页大小默认为30 |
>说明 >说明
@ -655,6 +649,8 @@
"code": "状态码", "code": "状态码",
"msg": "查询成功", "msg": "查询成功",
"data": { "data": {
"idNumber": "调查对象身份证号",
"userPhone": "分配的用户电话号码"
"value": { "value": {
}, },
"operationInfoList": [ "operationInfoList": [
@ -679,14 +675,14 @@
"version": "版本信息", "version": "版本信息",
"state": "已审核/待审核/已删除/已归档" "state": "已审核/待审核/已删除/已归档"
} }
} }
~~~ ~~~
### 2、查询待审核调查记录数量 ### 2、查询待审核调查记录数量
- url`/investigationRecord/underReviewRecordCount` - url`/record/underReviewRecordCount`
- method`GET` - method`GET`
@ -712,7 +708,7 @@
### 3、审核待审核调查记录 ### 3、审核待审核调查记录
- url`/investigationRecord/underReviewRecord` - url`/record/underReviewRecord`
- method****`PUT` - method****`PUT`
@ -724,7 +720,7 @@
{ {
"idNumber": "调查对象身份证号", "idNumber": "调查对象身份证号",
"pass": "true/false", //审核是否通过 "pass": "true/false", //审核是否通过
"passInfo": "审核信息", "msg": "审核信息",
"reviewerPhone": "审核者电话号码" "reviewerPhone": "审核者电话号码"
} }
~~~ ~~~
@ -743,7 +739,7 @@
### 4、修改已审核调查记录 ### 4、修改已审核调查记录
- url`/investigationRecord/investigationRecord` - url`/record/record`
- method`PUT` - method`PUT`
@ -754,8 +750,10 @@
~~~json ~~~json
{ {
"value": { "value": {
...
} },
"userPhone": "执行修改操作的用户的电话号码",
"msg": "备注";
} }
~~~ ~~~
@ -773,7 +771,7 @@
### 5、提交调查记录 ### 5、提交调查记录
- url`/investigationRecord/investigationRecord` - url`/record/record`
- method`POST` - method`POST`
@ -783,9 +781,12 @@
~~~json ~~~json
{ {
"idNumber": "调查对象身份证号",
"userPhone": "分配的用户的电话号码"
"value": { "value": {
... ...
} },
"msg": "备注"
} }
~~~ ~~~
@ -844,7 +845,8 @@
"name": "" "name": ""
} }
], ],
"wordTemplate": "" "wordTemplate": "",
"config": {}
} }
~~~ ~~~
@ -872,7 +874,7 @@
~~~json ~~~json
{ {
"name": "字段名" "name": "XXX"
} }
~~~ ~~~
@ -908,7 +910,8 @@
"name": "" "name": ""
} }
], ],
"wordTemplate": "" "wordTemplate": "",
"config": {}
} }
~~~ ~~~
@ -936,7 +939,7 @@
~~~json ~~~json
{ {
"name": "字段名" "name": "XXX"
} }
~~~ ~~~
@ -955,9 +958,10 @@
"name": "" "name": ""
} }
], ],
"wordTemplate": "" "wordTemplate": "",
"config": {}
} }
} }
~~~ ~~~