#目录
#缩写单词说明
缩写 | 说明 |
---|---|
lbms | [laboratory manage system]实验室管理系统 |
admin | [administrator]管理员 |
tea | [teacher]老师 |
num | [number]学生ID |
##学生模块 ###增添学生
-
描述 增加新的学生用户
-
请求地址
操作 path 协议 HTTP 数据格式 application/json 方法 POST ULR全径 http://$variable/lbms/student -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 name Y String 10byte 2 sex N String 1byte 性别'0'代表男'1'代表女 3 specialization Y String 10byte 专业 4 grade Y String 10byte 年级 5 contact Y String 2byte 联系方式 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
POST /lbms/student HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: 17a970cf-7e0d-cfc3-8e1e-b3d73e833569
{
"name":"李璠涛",
"sex":"0",
"specialization":"软件",
"grade":"2014",
"contact":"15667027637"
}
- 返回数据实例
{
"code": 200,
"object": "Zf7WV7XH"//登录账户名(很重要)
}
###删除学生
-
描述 删除学生用户
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 DELETE ULR全径 http://$variable/lbms/student/{numId} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 numId Y Integer 1byte 学生信息Id -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
DELETE /lbms/student/5 HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: a81ffcab-974d-d4f2-d5fc-21ab5965a610
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
- 返回数据实例
{
"code": 200,
"data": "删除成功"
}
###修改学生
-
描述 修改学生相关信息
-
请求地址
操作 path 协议 HTTP 数据格式 application/json 方法 PUT ULR全径 http://$variable/lbms/student -
请求参数 详情见请求实例
-
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
PUT /lbms/student HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: e189fe86-04b9-c3c8-e1d9-3883e221d727
{
"numid":4,
"name":"喵帕斯",
"sex":"1",
"specialization":"软件",
"grade":"2014",
"contact":"15667027637"
}
- 返回数据实例
{
"code": 200,
"data": "更新成功"
}
###获取全部学生信息
-
描述 获取全部学生用户
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/student/page/{currentPage} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 currentPage Y Integer 1byte 当前页码 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/student/page/1 HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: 8476daf0-1596-586c-8506-d456c8e8c192
- 返回数据实例
{
"code": 200,
"data": {
"currentPage": 1,
"pageSize": 8,
"recordCount": 1,
"recordList": [
{
"numid": 4,
"name": "喵帕斯",
"sex": "1",
"specialization": "软件",
"grade": "2014",
"date": null,
"contact": "15667027637"
}
],
"pageCount": 1,
"beginPageIndex": 1,
"endPageIndex": 1
}
}
###获取预约项目的学生
-
描述 获取预约了相关项目的学生
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/student/{batchId}/{currentPage} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 batchId Y Integer 1byte 项目批次ID 2 currentPage N Integer 1byte 当前页码 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/student/1/1 HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: f0805281-947b-517d-644d-f1a794d5f5f7
- 返回数据实例
{
"code": 200,
"data": {
"currentPage": 1,
"pageSize": 8,
"recordCount": 10,
"recordList": [
{
"numid": 4,
"name": "喵帕斯",
"sex": "1",
"specialization": "软件1405",
"grade": "2014",
"date": "2017-02-12 11:16:59.0",
"contact": "15667027637"
}
],
"pageCount": 2,
"beginPageIndex": 1,
"endPageIndex": 2
}
}
###通过年级查找学生
-
描述 获取相关年级的学生
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/student/page/grade/{grade}&{currentPage} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 grade Y Integer 1byte 年级 2 currentPage N Integer 1byte 当前页码 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/student/page/grade/2014&1 HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: 6da8369c-bd5a-4d05-9ec9-c8a5388affa0
- 返回数据实例
{
"code": 200,
"data": {
"currentPage": 1,
"pageSize": 8,
"recordCount": 10,
"recordList": [
{
"numid": 4,
"name": "喵帕斯",
"sex": "1",
"specialization": "软件1405",
"grade": "2014",
"date": "2017-02-12 11:16:59.0",
"contact": "15667027637"
},
{
"numid": 5,
"name": "李璠涛",
"sex": "1",
"specialization": "软件1405",
"grade": "2014",
"date": "2017-02-14 16:46:01.0",
"contact": "15667027637"
},
{
"numid": 6,
"name": "李璠涛",
"sex": "1",
"specialization": "软件1405",
"grade": "2014",
"date": "2017-02-14 16:46:06.0",
"contact": "15667027637"
},
{
"numid": 7,
"name": "李璠涛",
"sex": "1",
"specialization": "软件1405",
"grade": "2014",
"date": "2017-02-14 16:46:08.0",
"contact": "15667027637"
},
{
"numid": 8,
"name": "李璠涛",
"sex": "1",
"specialization": "软件1405",
"grade": "2014",
"date": "2017-02-14 16:46:09.0",
"contact": "15667027637"
},
{
"numid": 9,
"name": "李璠涛",
"sex": "1",
"specialization": "软件1405",
"grade": "2014",
"date": "2017-02-14 16:46:10.0",
"contact": "15667027637"
},
{
"numid": 10,
"name": "李璠涛",
"sex": "1",
"specialization": "软件1405",
"grade": "2014",
"date": "2017-02-14 16:46:11.0",
"contact": "15667027637"
},
{
"numid": 11,
"name": "李璠涛",
"sex": "1",
"specialization": "软件1405",
"grade": "2014",
"date": "2017-02-14 16:46:11.0",
"contact": "15667027637"
}
],
"pageCount": 2,
"beginPageIndex": 1,
"endPageIndex": 2
}
}
###通过专业查找学生
-
描述 获取相关年级的学生
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/student/page/special/{special}&{currentPage} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 special Y Integer 1byte 专业 2 currentPage Y Integer 1byte 当前页码 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/student/page/special/软件1405&1 HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: 7544bb08-1ed6-49d2-ce91-ade69d1004d6
- 返回数据实例
{
"code": 200,
"data": {
"currentPage": 1,
"pageSize": 8,
"recordCount": 10,
"recordList": [
{
"numid": 4,
"name": "喵帕斯",
"sex": "1",
"specialization": "软件1405",
"grade": "2014",
"date": "2017-02-12 11:16:59.0",
"contact": "15667027637"
},
{
"numid": 5,
"name": "李璠涛",
"sex": "1",
"specialization": "软件1405",
"grade": "2014",
"date": "2017-02-14 16:46:01.0",
"contact": "15667027637"
},
{
"numid": 6,
"name": "李璠涛",
"sex": "1",
"specialization": "软件1405",
"grade": "2014",
"date": "2017-02-14 16:46:06.0",
"contact": "15667027637"
},
{
"numid": 7,
"name": "李璠涛",
"sex": "1",
"specialization": "软件1405",
"grade": "2014",
"date": "2017-02-14 16:46:08.0",
"contact": "15667027637"
},
{
"numid": 8,
"name": "李璠涛",
"sex": "1",
"specialization": "软件1405",
"grade": "2014",
"date": "2017-02-14 16:46:09.0",
"contact": "15667027637"
},
{
"numid": 9,
"name": "李璠涛",
"sex": "1",
"specialization": "软件1405",
"grade": "2014",
"date": "2017-02-14 16:46:10.0",
"contact": "15667027637"
},
{
"numid": 10,
"name": "李璠涛",
"sex": "1",
"specialization": "软件1405",
"grade": "2014",
"date": "2017-02-14 16:46:11.0",
"contact": "15667027637"
},
{
"numid": 11,
"name": "李璠涛",
"sex": "1",
"specialization": "软件1405",
"grade": "2014",
"date": "2017-02-14 16:46:11.0",
"contact": "15667027637"
}
],
"pageCount": 2,
"beginPageIndex": 1,
"endPageIndex": 2
}
}
##教师模块 ###增加教师
-
描述 增加新教师用户
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/teacher -
请求参数 详情参见请求实例
-
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
POST /lbms/teacher HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: 8328f889-3582-81f1-f92f-de553b43d933
{
"name":"喵帕斯",
"sex":"1",
"title":"软件",
"education":"硕士",
"contact":"15667027637"
}
- 返回数据实例
{
"code": 200,
"data": "MTIc1pFF"//登录名很重要
}
###更新教师
-
描述 更新教师用户信息
-
请求地址
操作 path 协议 HTTP 数据格式 application/json 方法 GET ULR全径 http://$variable/lbms/teacher -
请求参数 详情见请求实例
-
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
PUT /lbms/teacher HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: 49f0b3af-83d6-66f3-0f5f-45f460027f00
{
"teaid":1,
"name":"喵帕斯",
"sex":"0",
"title":"软件",
"education":"硕士",
"contact":"15667027637"
}
- 返回数据实例
{
"code": 200,
"data": "更新成功"
}
###删除教师
-
描述 删除教师用户
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 DELETE ULR全径 http://$variable/lbms/teacher/{teaId} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 teaId Y String 1byte 教师ID -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
DELETE /lbms/teacher/2 HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: ede04d9a-f955-b7a8-420e-500c0c365a0f
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
------WebKitFormBoundary7MA4YWxkTrZu0gW--
- 返回数据实例
{
"code": 200,
"data": "删除成功"
}
###获取教师信息
-
描述 获取所有教师用户
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/teacher/page/{currentPage} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 currentPage Y String 1byte 当前页码 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
DELETE /lbms/teacher/2 HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: d189718e-41e9-1f5c-5abf-aaed24ff01f2
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
------WebKitFormBoundary7MA4YWxkTrZu0gW--
- 返回数据实例
{
"code": 200,
"data": "删除成功"
}
###获取教师信息
-
描述 获取所有教师用户
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/teacher/name/{name} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 name Y String 1byte 教师姓名 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/teacher/name/喵帕斯 HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: e245b483-c22b-5d8b-8e94-121e9a08cf43
- 返回数据实例
{
"code": 200,
"data": {
"teaid": 1,
"name": "喵帕斯",
"sex": "0",
"title": "软件",
"education": "硕士",
"date": null,
"contact": "15667027637"
}
}
##项目模块 ###增加项目
-
描述 增加新项目
-
请求地址
操作 path 协议 HTTP 数据格式 application/json 方法 POST ULR全径 http://$variable/lbms/item -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 itemname Y String 15byte 项目名称 2 term Y String 5byte 学期 3 coursename Y 15byte 课程名称 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
POST /lbms/item HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: e46f2df7-811f-ef3b-dd1f-14f764130338
{
"itemname":"C语言字符串课程设计",
"term":"第一学期",
"coursename":"C语言"
}
- 返回数据实例
{
"code": 200,
"data": "创建成功"
}
###更新项目
-
描述 更新项目信息
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 PUT ULR全径 http://$variable/lbms/item -
请求参数 详情见请求实例
-
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
PUT /lbms/item HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: c878a7bc-da3d-3943-229e-259d8e1dce77
{
"itemid":1,
"itemname":"排序算法练习",
"term":"第二学期",
"coursename":"数据结构与算法"
}
- 返回数据实例
{
"code": 200,
"data": "更新成功"
}
###删除项目信息
-
描述 删除项目信息
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 DELETE ULR全径 http://$variable/lbms/item/{itemId} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 itemId Y Integer 1byte 项目ID -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
DELETE /lbms/item/2 HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: 1e7a1670-307a-e2c8-872d-4ea9e55fd03c
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
------WebKitFormBoundary7MA4YWxkTrZu0gW--
- 返回数据实例
{
"code": 200,
"data": "删除成功"
}
###通过ID获取项目
-
描述 通过ID获取项目
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/item/{itemId} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 itemId Y Integer 1byte 项目ID -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/item/1 HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: d54b4070-ef2f-f05f-d9e1-1b5c8bdba4a9
- 返回数据实例
{
"code": 200,
"data": {
"itemid": 1,
"itemname": "排序算法练习",
"term": "第二学期",
"coursename": "数据结构与算法"
}
}
###获取项目信息
-
描述 获取所有项目信息
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/item/page/{currentPage} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 currentPage Y Integer 1byte 当前页码 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/item/page/1 HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: d54b4070-ef2f-f05f-d9e1-1b5c8bdba4a9
- 返回数据实例
{
"code": 200,
"data": {
"currentPage": 1,
"pageSize": 8,
"recordCount": 1,
"recordList": [
{
"itemid": 1,
"itemname": "排序算法练习",
"term": "第二学期",
"coursename": "数据结构与算法"
}
],
"pageCount": 1,
"beginPageIndex": 1,
"endPageIndex": 1
}
}
##项目批次模块 ###增加项目批次
-
描述 增加新的项目批次
-
请求地址
操作 path 协议 HTTP 数据格式 application/json 方法 POST ULR全径 http://$variable/lbms/batch -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 itemid Y Integer 1byte 项目ID 2 teaid Y Integer 1byte 分配教师ID 3 laboratory Y String 1byte 实验室地址 4 date Y String 1byte 实验日期 5 segmentation Y String 1byte 节次 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
POST /lbms/batch HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: fdc34ca7-ec3d-1207-a966-c51976f04bfa
{
"itemid":1,
"teaid":1,
"laboratory":"FF104",
"date":"2017-02-12",
"segmentation":"3,4节"
}
- 返回数据实例
{
"code": 200,
"data": "创建成功"
}
###更新项目批次
-
描述 更新项目批次安排
-
请求地址
操作 path 协议 HTTP 数据格式 application/json 方法 POST ULR全径 http://$variable/lbms/batch -
请求参数 详情见请求实例
-
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
PUT /lbms/batch HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: 8b3fd6b1-54c3-785a-1ac7-5d7d95b815d7
{
"batid":1,
"itemid":1,
"teaid":1,
"laboratory":"FF104",
"date":"2017-02-12",
"segmentation":"5,6节"
}
- 返回数据实例
{
"code": 200,
"data": "更新成功"
}
###删除项目批次
-
描述 删除项目批次安排
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 DELETE ULR全径 http://$variable/lbms/batch/{batchId} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 batchId Y Integer 1byte 项目批次ID -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
DELETE /lbms/batch/2 HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: 86e31b39-43f7-fac1-b865-f8c61bb62917
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
------WebKitFormBoundary7MA4YWxkTrZu0gW--
- 返回数据实例
{
"code": 200,
"data": "删除成功"
}
###获取项目批次通过ID
-
描述 获取项目批次通过ID
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/batch/{batId} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 batId Y String 1byte 项目批次ID -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/batch/1 HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: c808ef0a-73e6-4463-7865-e5ed99df1f89
- 返回数据实例
{
"code": 200,
"data": {
"batid": 1,
"itemid": 1,
"teaid": 1,
"laboratory": "FF104",
"date": "2017-02-12",
"segmentation": "5,6节",
"sure": null
}
}
###获取项目批次信息
-
描述 获取所有项目批次信息
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/batch/page/{currentPage} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 currentPage Y String 1byte 当前页码 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/batch/page/1 HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: c808ef0a-73e6-4463-7865-e5ed99df1f89
- 返回数据实例
{
"code": 200,
"data": {
"currentPage": 1,
"pageSize": 8,
"recordCount": 1,
"recordList": [
{
"batid": 1,
"itemid": 1,
"teaid": 1,
"laboratory": "FF104",
"date": "2017-02-12",
"segmentation": "5,6节",
"sure": null
}
],
"pageCount": 1,
"beginPageIndex": 1,
"endPageIndex": 1
}
}
##管理员账户模块 ###增加管理员
-
描述 增加管理员
-
请求地址
操作 path 协议 HTTP 数据格式 application/json 方法 POST ULR全径 http://$variable/lbms/administrator -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 name Y String 20byte 姓名 2 sex Y String 1byte 0男,1女 3 contact Y String 20byte 联系方式 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
POST /lbms/administrator HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: 36a269f4-bef0-4d39-9cfe-0575a0d4c03f
{
"name":"李璠涛",
"sex":"0",
"contact":"15667027637"
}
- 返回数据实例
{
"code": 200,
"data": "WID0JGxL"//登录账号 很重要
}
###更新管理员
-
描述 更新管理员信息
-
请求地址
操作 path 协议 HTTP 数据格式 application/json 方法 PUT ULR全径 http://$variable/lbms/administrator -
请求参数 详情见请求实例
-
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
PUT /lbms/administrator HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: 5a2a2665-93a1-6980-bcac-d8a97886b69e
{
"admid":"1",
"name":"喵帕斯",
"sex":"1",
"contact":"15667027637"
}
- 返回数据实例
{
"code": 200,
"data": "更新成功"
}
###删除管理员
-
描述 删除管理员(只有超级管理员有此权限)
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/administrator/{adId} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 adId Y String 1byte 管理员ID -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
DELETE /lbms/administrator/2 HTTP/1.1
Host: localhost:8080
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
Cache-Control: no-cache
Postman-Token: e5755ef2-b3ef-e9b9-a13e-130adb33f978
------WebKitFormBoundary7MA4YWxkTrZu0gW--
- 返回数据实例
{
"code": 200,
"data": "删除成功"
}
###获取所有管理员
-
描述 获取所有管理员用户信息
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/administrator/page/{currentPage} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 currentPage Y String 1byte 当前页码 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/administrator/page/1 HTTP/1.1
Host: localhost:8080
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
Postman-Token: 5b553074-7ba0-3743-ff4e-6dc96902958b
- 返回数据实例
{
"code": 200,
"data": {
"currentPage": 1,
"pageSize": 8,
"recordCount": 1,
"recordList": [
{
"admid": 1,
"itemid": null,
"name": "喵帕斯",
"sex": "1",
"contact": "15667027637"
}
],
"pageCount": 1,
"beginPageIndex": 1,
"endPageIndex": 1
}
}
###获取相关管理员
-
描述 获取登录管理员个人信息
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/administrator/{adId} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 adId Y Integer 1byte 管理员账户ID -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/administrator/1 HTTP/1.1
Host: localhost:8080
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
Postman-Token: db4811d3-6c1c-7d25-a942-86a5e7402054
- 返回数据实例
{
"code": 200,
"data": {
"admid": 1,
"itemid": null,
"name": "喵帕斯",
"sex": "1",
"contact": "15667027637"
}
}
###修改相关管理员密码
-
描述 修改登录管理员密码
-
请求地址
操作 path 协议 HTTP 数据格式 String 方法 POST ULR全径 http://$variable/lbms/cipher/administrator -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 password Y String 8byte 必须为A-Z或a-z ASCLL字符 2 adId Y Integer 1byte 管理员ID -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
POST /lbms/cipher/administrator HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: 2d3ddbf6-2396-6495-f773-c320b7f8b05a
Content-Type: application/x-www-form-urlencoded
password=yiranblade&adId=1
- 返回数据实例
{
"code": 500,
"data": "更新失败"
}
##公告栏模块 ###增加公告栏
-
描述 增加新公告
-
请求地址
操作 path 协议 HTTP 数据格式 application/json 方法 POST ULR全径 http://$variable/lbms/notice -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 noticetile Y String 20byte 公告标题 2 noticecontent Y String 50byte 公告内容 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
POST /lbms/notice HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: b8f7617d-81ba-34c1-5e2b-291a6b2df1b2
{
"noticetile":"先关于实验取消",
"noticecontent":"今天下午所有实验课取消"
}
- 返回数据实例
{
"code": 200,
"data": "添加成功"
}
###更新公告栏
-
描述 更新公告信息
-
请求地址
操作 path 协议 HTTP 数据格式 application/json 方法 PUT ULR全径 http://$variable/lbms/notice -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 noticeid Y Integer 1byte 公告ID 2 noticetile Y String 1byte 公告标题 3 noticecontent Y String 1byte 公告内容 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
PUT /lbms/notice HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: 99c86328-c50d-3a42-0cad-5c780e839b8c
{
"noticeid":"1",
"noticetile":"通知",
"noticecontent":"今天下午所有实验课取消"
}
start=A&end=B
- 返回数据实例
{
"code": 200,
"data": "更新成功"
}
###删除公告信息
-
描述 删除公告信息
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 DELETE ULR全径 http://$variable/lbms/notice/{noticeId} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 noticeId Y Integer 1byte 公告ID -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
DELETE /lbms/notice/2 HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: b4c208ec-876b-4750-4dac-bf3a3c1361c5
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
------WebKitFormBoundary7MA4YWxkTrZu0gW--
- 返回数据实例
{
"code": 200,
"data": "删除成功"
}
###获取所有公告信息
-
描述 获取所有公告信息
-
请求地址
操作 path 协议 HTTP 数据格式 String 方法 GET ULR全径 http://$variable/lbms/notice/page/{currentPage} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 currentPage Y Integer 1byte 当前页码 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/notice/page/1 HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: 2fe777b8-ea00-e5e5-2ea2-016b77557e18
- 返回数据实例
{
"code": 200,
"data": {
"currentPage": 1,
"pageSize": 8,
"recordCount": 1,
"recordList": [
{
"noticeid": 1,
"noticetile": "通知",
"noticecontent": "今天下午所有实验课取消",
"date": null
}
],
"pageCount": 1,
"beginPageIndex": 1,
"endPageIndex": 1
}
}
###获取项目批次下所有成绩
-
描述 获取项目批次下所有成绩
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/test/batch/{batchId} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 batchId Y Integer 1byte 项目批次ID -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/test/batch/1 HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: 2fe777b8-ea00-e5e5-2ea2-016b77557e18
- 返回数据实例
{
"code": 200,
"data": [
{
"testid": 2,
"batid": 1,
"numid": 4,
"grade": "2014",
"results": 98,
"date": null
}
]
}
##学生相关接口 ###获取已经预约项目
-
描述 获取学生已经预约的项目批次
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/batch/student/{numId} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 numId Y String 1byte 学生ID -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,500请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/batch/student/4 HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: f25aeb12-4483-1b11-63a0-b8c19fa43237
- 返回数据实例
{
"code": 200,
"data": [
{
"batid": 1,
"itemid": 1,
"teaid": 1,
"laboratory": "FF104",
"date": "2017-02-12",
"segmentation": "5,6节",
"sure": null
}
]
}
###预约项目
-
描述 学生用户预约实验项目批次
-
请求地址
操作 path 协议 HTTP 数据格式 String 方法 PUT ULR全径 http://$variable/lbms/batch/student/{batchId}&{numId} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 batchId Y Integer 1byte 预约的实验批次ID 2 numId Y Integer 1byte 预约学生的ID -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
PUT /lbms/batch/student/1&4 HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: e97e2df2-0eca-d037-2dda-25af7578c1a0
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
------WebKitFormBoundary7MA4YWxkTrZu0gW--
- 返回数据实例
{
"code": 200,
"data": "创建成功"
}
###获取学生成绩
-
描述 获取学生成绩
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/test/{batchId}&{numId} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 batchId Y Integer 1byte 实验批次ID 2 numId Y Integer 1byte 学生的ID -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/test/1&4 HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: 72cb8d72-bb7d-4fcb-9733-7c96464d1114
- 返回数据实例
{
"code": 200,
"data": {
"testid": 2,
"batid": 1,
"numid": 4,
"grade": "2014",
"results": 98,
"date": null
}
}
###获取相关学生信息
-
描述 获取登录学生信息
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/student/{numId} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 numId Y Integer 1byte 学生ID -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/student/4 HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: b24a47c2-9b85-7efc-e412-0a54ed45ae2a
- 返回数据实例
{
"code": 200,
"data": {
"numid": 4,
"name": "喵帕斯",
"sex": "1",
"specialization": "软件",
"grade": "2014",
"date": "2017-02-12 11:16:59.0",
"contact": "15667027637"
}
}
###更新相关学生密码信息
-
描述 更新登录学生密码信息
-
请求地址
操作 path 协议 HTTP 数据格式 String 方法 POST ULR全径 http://$variable/lbms/cipher/student -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 password Y String 1byte 修改后的密码 2 numId N String 1byte 学生ID -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
POST /lbms/cipher/student HTTP/1.1
Host: localhost:8080
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
Postman-Token: d1498dd1-3662-b012-b08f-4efe02ad4f0e
password=yiranblade&numId=4
- 返回数据实例
{
"code": 200,
"data": "更新成功"
}
##教师相关接口 ###获取安排项目
-
描述 获取所有安排给当前教师的项目
-
请求地址
操作 path 协议 HTTP 数据格式 String 方法 GET ULR全径 http://$variable/lbms/batch/teacher/{teaId}&{currentPage} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 teaId Y Integer 1byte 教师ID 2 currentPage Y Integer 1byte 当前页码 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/batch/teacher/1&1 HTTP/1.1
Host: localhost:8080
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
Postman-Token: 3746fb4a-53bf-de6c-ae85-a9dcddede472
- 返回数据实例
{
"code": 200,
"data": {
"currentPage": 1,
"pageSize": 8,
"recordCount": 1,
"recordList": [
{
"batid": 1,
"itemid": 1,
"teaid": 1,
"laboratory": "FF104",
"date": "2017-02-12",
"segmentation": "5,6节",
"sure": null
}
],
"pageCount": 1,
"beginPageIndex": 1,
"endPageIndex": 1
}
}
###写入学生实验成绩
-
描述 写学生成绩
-
请求地址
操作 path 协议 HTTP 数据格式 application/json 方法 PUT ULR全径 http://$variable/lbms/test -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 testid Y String 1byte 成绩ID 2 batid Y String 1byte 实验项目批次ID 3 numid Y String 1byte 学生ID 4 grade Y String 10byte 年级 5 results Y Integer 1byte 分数 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
PUT /lbms/test HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: 14a16e11-c75a-a5b6-ca40-a0e94017e139
{
"testid":"2",
"batid":"1",
"numid":"4",
"grade":"2014",
"results":"98"
}
- 返回数据实例
{
"code": 200,
"data": "更新成功"
}
###获取相关教师信息
-
描述 获取登录教师相关信息
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 GET ULR全径 http://$variable/lbms/teacher/{teaId} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 teaId Y String 1byte 教师ID -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/teacher/1 HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Cache-Control: no-cache
Postman-Token: ade05a28-b755-6f36-3e4b-7ac29a48a13d
- 返回数据实例
{
"code": 200,
"data": {
"teaid": 1,
"name": "喵帕斯",
"sex": "0",
"title": "软件",
"education": "硕士",
"date": null,
"contact": "15667027637"
}
}
###修改相关教师密码
-
描述 登录教师修改密码
-
请求地址
操作 path 协议 HTTP 数据格式 Integer 方法 POST ULR全径 http://$variable/lbms/cipher/teacher -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 password Y String 20byte 修改后的密码 2 teaId N String 1byte 教师ID -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,400请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
POST /lbms/cipher/teacher HTTP/1.1
Host: localhost:8080
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
Postman-Token: 36c26b44-b81f-c098-0e9a-f580890943cc
password=yiranblade&teaId=1
- 返回数据实例
{
"code": 200,
"data": "更新成功"
}
##登录相关接口 ###登录系统
-
描述 登录系统
-
请求地址
操作 path 协议 HTTP 数据格式 application/x-www-form-urlencoded 方法 POST ULR全径 http://$variable/lbms/login -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 userName Y String 1byte 必须为A-Z或a-z ASCLL字符 2 password Y String 1byte 必须为A-Z或a-z ASCLL字符 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,500请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
POST /lbms/login HTTP/1.1
Host: localhost:8080
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
Postman-Token: 93266c51-f4c3-2b3a-ca20-82d7566172d0
userName=Zf7WV7XH&password=yiranblade
- 返回数据实例
{
"code": 200,
"data": "登录成功"
}
###<span id=“getUserInfo">获取登录信息
-
描述 通过用户名获取用户登录的身份信息
-
请求地址
操作 path 协议 HTTP 数据格式 String 方法 GET ULR全径 http://$variable/lbms/login/{userName} -
请求参数
序号 参数名 必选 数据类型 长度 备注 1 userName Y String 8byte 必须为A-Z或a-z ASCLL字符 -
返回数据
序号 返回值 中文名称 备注 1 code 请求状态码 200请求成功,500请求失败 2 data 返回数据 json格式数据,字符串 -
请求URL实例
GET /lbms/login/Zf7WV7XH HTTP/1.1
Host: localhost:8080
Cache-Control: no-cache
Postman-Token: 3a267299-50b8-89a6-9578-0a5b3cb0ce44
- 返回数据实例
{
"code": 200,
"data": {
"userName": "Zf7WV7XH",
"userId": 4,
"power": "student"
}
}
#错误状态码说明
序号 | 状态码 | 说明 |
---|---|---|
1 | 200 | 请求发送成功 |
2 | 400 | 数据格式错误 |
4 | 500 | 服务器发生未知错误 |
5 | 501 | 请求过于频繁 |