Skip to content

Latest commit

 

History

History
2300 lines (1883 loc) · 94.5 KB

easy-api.md

File metadata and controls

2300 lines (1883 loc) · 94.5 KB

zuccqa

UserController

addUser

基本信息

Path: /user/add

Method: POST

**接口描述:**添加用户

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json application/json

Body

名称类型是否必须默认值备注其他信息
idstring必须用户ID
namestring必须用户姓名
ageinteger必须用户年龄
passwordstring必须用户密码
positioninteger必须用户身份(0:学生,1:教师,2:管理员)

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**请求示例**
{
  "id": "31901024",
  "name": "qij",
  "age": 21,
  "password": "31901024",
  "position": 0
}

返回示例

{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "id": "31901024",
    "name": "qij",
    "age": 21,
    "password": "31901024",
    "position": 0
  }
}

deleteUser

基本信息

Path: /user/delete

Method: DELETE

**接口描述:**删除用户

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded application/x-www-form-urlencoded

Query

参数名称 是否必须 示例 备注
id 311900 用户ID

返回数据

名称类型是否必须默认值备注其他信息
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功"
}

findById

基本信息

Path: /user/findById

Method: GET

**接口描述:**通过用户id查询

请求参数

Query

参数名称 是否必须 示例 备注
id 31901025 用户ID

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "id": "31901025",
    "name": "邵育华",
    "age": 21,
    "password": "Benjamin",
    "position": 0
  }
}

findByName

基本信息

Path: /user/findByName

Method: GET

**接口描述:**通过用户名称查询

请求参数

Query

参数名称 是否必须 示例 备注
name syh 用户姓名

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": [
    {
      "id": "31901025",
      "name": "邵育华",
      "age": 21,
      "password": "Benjamin",
      "position": 0
    }
  ]
}

getAll

基本信息

Path: /user/getAll

Method: GET

**接口描述:**获取用户列表

请求参数

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": [
    {
      "id": "31901025",
      "name": "邵育华",
      "age": 21,
      "password": "Benjamin",
      "position": 0
    },
    {
      "id": "311003",
      "name": "benben",
      "age": 42,
      "password": "123456",
      "position": 1
    },
    {
      "id": "31901024",
      "name": "qij",
      "age": 21,
      "password": "31901024",
      "position": 0
    }
  ]
}

login

基本信息

Path: /user/login

Method: POST

**接口描述:**登录验证

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded application/x-www-form-urlencoded
Query
参数名称 是否必须 示例 备注
id 31901025 用户ID
password 123 用户密码

返回数据

名称类型是否必须默认值备注其他信息
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "id": "31901025",
    "name": "邵育华",
    "age": 21,
    "password": "123456",
    "position": 0
  }
}

modifyPwd

基本信息

Path: /user/modifyPwd

Method: POST

**接口描述:**修改密码

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded application/x-www-form-urlencoded
Query
参数名称 是否必须 示例 备注
id 31901025 用户ID
oldPwd 123 用户原密码
newPwd 123456 用户新密码

返回数据

名称类型是否必须默认值备注其他信息
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "id": "31901025",
    "name": "邵育华",
    "age": 21,
    "password": "123456",
    "position": 0
  }
}

updateUser

基本信息

Path: /user/update

Method: PUT

**接口描述:**修改用户个人信息

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json application/json
Body
名称类型是否必须默认值备注其他信息
idstring必须用户ID
namestring必须用户姓名
ageinteger必须用户年龄
passwordstring必须用户密码
positioninteger必须用户身份(0:学生,1:教师,2:管理员)

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**请求示例**
{
  "id": "31901025",
  "name": "邵育华",
  "age": 21,
  "password": "Benjamin",
  "position": 0
}

返回示例

{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "id": "31901025",
    "name": "邵育华",
    "age": 21,
    "password": "Benjamin",
    "position": 0
  }
}

ModelController

addModel

基本信息

Path: /model/add

Method: POST

**接口描述:**添加模板

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json application/json
Body
名称类型是否必须默认值备注其他信息
modelIDstring必须模版ID
modelNamestring必须模版名
questionListobject []必须问题列表

item 类型: object

├─ questionTitlestring必须问题标题
├─ questionTypeinteger必须问题类型(0:单选题,1:多选题,2:主观题)
├─ optionsstring []必须选项(列表长度:{0:主观题,1:单选题,2:多选题})

item 类型: string

├─ 非必须

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**请求示例**
{
  "modelID": "1",
  "modelName": "模板1",
  "questionList": [
    {
      "questionTitle": "今天课程的难度怎么样",
      "questionType": 0,
      "options": [
        "",
        "一般",
        "简单"
      ]
    },
    {
      "questionTitle": "你对课程有什么建议吗",
      "questionType": 2,
      "options": [
      ]
    }
  ]
}

返回示例

{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "modelID": "62426e2b5955a67245505276",
    "modelName": "模板1",
    "questionList": [
      {
        "questionTitle": "今天课程的难度怎么样",
        "questionType": 0,
        "options": [
          "",
          "一般",
          "简单"
        ]
      },
      {
        "questionTitle": "你对课程有什么建议吗",
        "questionType": 2,
        "options": []
      }
    ]
  }
}

deleteModel

基本信息

Path: /model/delete

Method: DELETE

**接口描述:**删除模板

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded application/x-www-form-urlencoded
Query
参数名称 是否必须 示例 备注
id 1 模板ID

返回数据

名称类型是否必须默认值备注其他信息
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功"
}

findById

基本信息

Path: /model/find

Method: GET

**接口描述:**通过模板id查询模板信息

请求参数

Query

参数名称 是否必须 示例 备注
id 1 模板ID

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "modelID": "62426e2b5955a67245505276",
    "modelName": "模板1",
    "questionList": [
      {
        "questionTitle": "今天课程的难度怎么样",
        "questionType": 0,
        "options": [
          "",
          "一般",
          "简单"
        ]
      },
      {
        "questionTitle": "你对课程有什么建议吗",
        "questionType": 2,
        "options": []
      }
    ]
  }
}

findByName

基本信息

Path: /model/findByName

Method: GET

**接口描述:**通过模板名称查询模板信息

请求参数

Query

参数名称 是否必须 示例 备注
name model1 模板名称

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": [
    {
      "modelID": "624271485955a67245505277",
      "modelName": "模板2",
      "questionList": [
        {
          "questionTitle": "今天课程的难度怎么样",
          "questionType": 1,
          "options": [
            "",
            "一般",
            "简单"
          ]
        },
        {
          "questionTitle": "你对课程有什么建议吗",
          "questionType": 2,
          "options": []
        }
      ]
    }
  ]
}

getAll

基本信息

Path: /model/getAll

Method: GET

**接口描述:**查看所有模板列表中的模板

请求参数

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": [
    {
      "modelID": "62426e2b5955a67245505276",
      "modelName": "模板1",
      "questionList": [
        {
          "questionTitle": "今天课程的难度怎么样",
          "questionType": 0,
          "options": [
            "",
            "一般",
            "简单"
          ]
        },
        {
          "questionTitle": "你对课程有什么建议吗",
          "questionType": 2,
          "options": []
        }
      ]
    },
    {
      "modelID": "624271485955a67245505277",
      "modelName": "模板2",
      "questionList": [
        {
          "questionTitle": "今天课程的难度怎么样",
          "questionType": 1,
          "options": [
            "",
            "一般",
            "简单"
          ]
        },
        {
          "questionTitle": "你对课程有什么建议吗",
          "questionType": 2,
          "options": []
        }
      ]
    }
  ]
}

updateModel

基本信息

Path: /model/update

Method: PUT

**接口描述:**修改模板信息

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json application/json
Body
名称类型是否必须默认值备注其他信息
modelIDstring必须模版ID
modelNamestring必须模版名
questionListobject []必须问题列表

item 类型: object

├─ questionTitlestring必须问题标题
├─ questionTypeinteger必须问题类型(0:单选题,1:多选题,2:主观题)
├─ optionsstring []必须选项(列表长度:{0:主观题,1:单选题,2:多选题})

item 类型: string

├─ 非必须

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**请求示例**
{
  "modelID": "62426e2b5955a67245505276",
  "modelName": "模板1",
  "questionList": [
    {
      "questionTitle": "今天课程的难度怎么样",
      "questionType": 0,
      "options": [
        "",
        "一般",
        "简单"
      ]
    },
    {
      "questionTitle": "请问你的hadoop配置完了哪些选项",
      "questionType": 1,
      "options": [
          "Hadoop+Hdfs",
          "Hadoop+Hbase",
          "Hadoop+Hbase+MongDB"
      ]
    },
    {
      "questionTitle": "你对课程有什么建议吗",
      "questionType": 2,
      "options": [
      ]
    }
  ]
}

返回示例

{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "modelID": "62426e2b5955a67245505276",
    "modelName": "模板1",
    "questionList": [
      {
        "questionTitle": "今天课程的难度怎么样",
        "questionType": 0,
        "options": [
          "",
          "一般",
          "简单"
        ]
      },
      {
        "questionTitle": "请问你的hadoop配置完了哪些选项",
        "questionType": 1,
        "options": [
          "Hadoop+Hdfs",
          "Hadoop+Hbase",
          "Hadoop+Hbase+MongDB"
        ]
      },
      {
        "questionTitle": "你对课程有什么建议吗",
        "questionType": 2,
        "options": []
      }
    ]
  }
}

AnswerController

addAnswer

基本信息

Path: /answer/add

Method: POST

**接口描述:**添加学生答题结果

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json application/json
Body
名称类型是否必须默认值备注其他信息
answerSheetIdstring必须问卷表单ID
studentIdstring必须学生ID
feedbackIdstring必须问卷ID
answersarray []必须回答列表

item 类型: array

├─ 非必须
├─ 非必须
submitDatestring必须提交时间

mock: @datetime

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**请求示例**
{
  "answerSheetId": "1",
  "studentId": "31901025",
  "feedbackId": "1",
  "answers": [
    [
      ""
    ],
    [
      "作业太多辣!!!"
    ]
  ],
  "submitDate": "2022-03-29T23:17:54.000Z"
}

返回示例

{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "answerSheetId": "62427d38379bdf15b512c565",
    "studentId": "31901025",
    "feedbackId": "1",
    "answers": [
      [
        ""
      ],
      [
        "作业太多辣!!!"
      ]
    ],
    "submitDate": "2022-03-29T23:17:54.000+00:00"
  }
}

deleteAnswer

基本信息

Path: /answer/delete

Method: DELETE

**接口描述:**删除一个回答记录

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded application/x-www-form-urlencoded
Query
参数名称 是否必须 示例 备注
id 1 问卷填写表ID

返回数据

名称类型是否必须默认值备注其他信息
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功"
}

findByFeedbackId

基本信息

Path: /answer/findByFeedbackId

Method: GET

**接口描述:**通过问卷id查询回答记录

请求参数

Query

参数名称 是否必须 示例 备注
feedbackId 1 问卷ID

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "answerSheetId": "62427d38379bdf15b512c565",
    "studentId": "31901025",
    "feedbackId": "1",
    "answers": [
      [
        ""
      ],
      [
        "作业太多辣!!!"
      ]
    ],
    "submitDate": "2022-03-29T23:17:54.000+00:00"
  }
}

findById

基本信息

Path: /answer/findById

Method: GET

**接口描述:**通过回答结果id查询回答内容

请求参数

Query

参数名称 是否必须 示例 备注
id 1 问卷填写表ID

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "answerSheetId": "62427d38379bdf15b512c565",
    "studentId": "31901025",
    "feedbackId": "1",
    "answers": [
      [
        ""
      ],
      [
        "作业太多辣!!!"
      ]
    ],
    "submitDate": "2022-03-29T23:17:54.000+00:00"
  }
}

findByUserId

基本信息

Path: /answer/findByUserId

Method: GET

**接口描述:**通过答题用户的id查询回答内容

请求参数

Query

参数名称 是否必须 示例 备注
userId 31901025 用户ID

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "answerSheetId": "62427d38379bdf15b512c565",
    "studentId": "31901025",
    "feedbackId": "1",
    "answers": [
      [
        ""
      ],
      [
        "作业太多辣!!!"
      ]
    ],
    "submitDate": "2022-03-29T23:17:54.000+00:00"
  }
}

findByUserIdAndFeedbackId

基本信息

Path: /answer/findByUserAndFeedback

Method: GET

**接口描述:**通过填写问卷的用户id和问卷id一起查询

请求参数

Query

参数名称 是否必须 示例 备注
userId 31901025 用户ID
feedbackId 1 问卷ID

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "answerSheetId": "62427d38379bdf15b512c565",
    "studentId": "31901025",
    "feedbackId": "1",
    "answers": [
      [
        ""
      ],
      [
        "作业太多辣!!!"
      ]
    ],
    "submitDate": "2022-03-29T23:17:54.000+00:00"
  }
}

getAll

基本信息

Path: /answer/getAll

Method: GET

**接口描述:**查询所有问答记录

请求参数

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": [
    {
      "answerSheetId": "62427d38379bdf15b512c565",
      "studentId": "31901025",
      "feedbackId": "1",
      "answers": [
        [
          ""
        ],
        [
          "作业太多辣!!!"
        ]
      ],
      "submitDate": "2022-03-29T23:17:54.000+00:00"
    },
    {
      "answerSheetId": "62427f86379bdf15b512c566",
      "studentId": "consequat ad amet mollit",
      "feedbackId": "mollit eu Lorem non",
      "answers": [
        [
          "aliqua Duis quis laboris sint"
        ],
        [
          "commodo minim"
        ],
        [
          "ex ut ad",
          "eiusmod magna ut",
          "exercitation voluptate",
          "fugiat proident labore",
          "in fugiat"
        ],
        [
          "dolore velit ex Lorem",
          "pariatur cupidatat dolor fugiat"
        ]
      ],
      "submitDate": "1974-08-09T21:34:31.000+00:00"
    }
  ]
}

updateAnswer

基本信息

Path: /answer/update

Method: PUT

**接口描述:**修改回答记录

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json application/json
Body
名称类型是否必须默认值备注其他信息
answerSheetIdstring必须问卷表单ID
studentIdstring必须学生ID
feedbackIdstring必须问卷ID
answersarray []必须回答列表

item 类型: array

├─ 非必须
├─ 非必须
submitDatestring必须提交时间

mock: @datetime

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**请求示例**
{
      "answerSheetId": "62427f86379bdf15b512c566",
      "studentId": "31901001",
      "feedbackId": "1",
      "answers": [
        [
          ""
        ],
        [
          "Hadoop+Hdfs"
        ],
        [
          "太难啦"
        ]
      ],
      "submitDate": "2022-03-29T10:00:00.000+00:00"
}

返回示例

{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "answerSheetId": "62427f86379bdf15b512c566",
    "studentId": "31901001",
    "feedbackId": "1",
    "answers": [
      [
        ""
      ],
      [
        "Hadoop+Hdfs"
      ],
      [
        "太难啦"
      ]
    ],
    "submitDate": "2022-03-29T10:00:00.000+00:00"
  }
}

CourseController

addCourse

基本信息

Path: /course/add

Method: POST

**接口描述:**添加课程

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json application/json
Body
名称类型是否必须默认值备注其他信息
courseIdstring必须课程ID
courseNamestring必须课程名
studentIdListstring []必须学号列表

item 类型: string

├─ 非必须
teacherIdstring必须教师
courseDateobject必须课程时间{周几:[第几节课]}
├─ 0integer []必须

item 类型: integer

├─ 非必须

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**请求示例**
{
  "courseId": "1",
  "courseName": "大数据计算技术",
  "studentIdList": [
    "31901025",
    "31901028",
    "31901022"
  ],
  "teacherId": "311003",
  "courseDate": {
    "1": [
      5,6
    ]
  }
}

返回示例

{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "courseId": "62425ea55955a67245505273",
    "courseName": "大数据计算技术",
    "studentIdList": [
      "31901025",
      "31901028",
      "31901022"
    ],
    "teacherId": "311003",
    "courseDate": {
      "1": [
        5,
        6
      ]
    }
  }
}

deleteCourse

基本信息

Path: /course/delete

Method: DELETE

**接口描述:**删除课程

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded application/x-www-form-urlencoded
Query
参数名称 是否必须 示例 备注
id 1 课程ID

返回数据

名称类型是否必须默认值备注其他信息
rspCodestring必须200
rspMsgstring必须操作成功
```json { "rspCode": "200", "rspMsg": "操作成功" } ```

findById

基本信息

Path: /course/findById

Method: GET

**接口描述:**通过课程id查询课程信息

请求参数

Query

参数名称 是否必须 示例 备注
id 1 课程ID

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "courseId": "624266105955a67245505275",
    "courseName": "大数据计算技术",
    "studentIdList": [
      "31901025",
      "31901028",
      "31901022"
    ],
    "teacherId": "311003",
    "courseDate": {
      "3": [
        5,
        6
      ]
    }
  }
}

findByName

基本信息

Path: /course/findByName

Method: GET

**接口描述:**通过课程名称查询课程信息

请求参数

Query

参数名称 是否必须 示例 备注
name JAVA 课程名称

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
```json { "rspCode": "200", "rspMsg": "操作成功", "data": [ { "courseId": "1", "courseName": "大数据计算技术", "studentIdList": [ "31901025", "31901028", "31901022", "31901001", "31901024" ], "teacherId": "311003", "courseDate": { "1": [ 5, 6, 7 ] } }, { "courseId": "624266105955a67245505275", "courseName": "大数据计算技术", "studentIdList": [ "31901025", "31901028", "31901022" ], "teacherId": "311003", "courseDate": { "3": [ 5, 6 ] } } ] } ```

getAll

基本信息

Path: /course/getAll

Method: GET

**接口描述:**查看课程列表,所有课程

请求参数

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": [
    {
      "courseId": "62425ea55955a67245505273",
      "courseName": "大数据计算技术",
      "studentIdList": [
        "31901025",
        "31901028",
        "31901022"
      ],
      "teacherId": "311003",
      "courseDate": {
        "1": [
          5,
          6
        ]
      }
    },
    {
      "courseId": "62425fe85955a67245505274",
      "courseName": "软件工程",
      "studentIdList": [
        "31901025",
        "31901028",
        "31901022"
      ],
      "teacherId": "311900",
      "courseDate": {
        "3": [
          5,
          6,
          7
        ]
      }
    }
  ]
}

updateCourse

基本信息

Path: /course/update

Method: PUT

**接口描述:**修改课程信息

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json application/json
Body
名称类型是否必须默认值备注其他信息
courseIdstring必须课程ID
courseNamestring必须课程名
studentIdListstring []必须学号列表

item 类型: string

├─ 非必须
teacherIdstring必须教师
courseDateobject必须课程时间{周几:[第几节课]}
├─ 0integer []必须

item 类型: integer

├─ 非必须

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**请求示例**
{
  "courseId": "62425ea55955a67245505273",
  "courseName": "大数据计算技术",
  "studentIdList": [
    "31901025",
    "31901028",
    "31901022",
    "31901001",
    "31901024"
  ],
  "teacherId": "311003",
  "courseDate": {
    "1": [
      5,6,7
    ]
  }
}

返回示例

{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "courseId": "62425ea55955a67245505273",
    "courseName": "大数据计算技术",
    "studentIdList": [
      "31901025",
      "31901028",
      "31901022",
      "31901001",
      "31901024"
    ],
    "teacherId": "311003",
    "courseDate": {
      "1": [
        5,
        6,
        7
      ]
    }
  }
}

FeedbackController

addFeedback

基本信息

Path: /feedback/add

Method: POST

**接口描述:**发布问卷 添加

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json application/json

Body

名称类型是否必须默认值备注其他信息
feedbackIdstring必须问卷ID
feedbackCourseIdstring必须问卷课程ID
feedbackTitlestring必须问卷标题
creatTimestring必须创建时间

mock: @datetime

startTimestring必须开始时间

mock: @datetime

endTimestring必须结束时间

mock: @datetime

questionListobject []必须问题列表

item 类型: object

├─ questionTitlestring必须问题标题
├─ questionTypeinteger必须问题类型(0:单选题,1:多选题,2:主观题)
├─ optionsstring []必须选项(列表长度:{0:主观题,1:单选题,2:多选题})

item 类型: string

├─ 非必须

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**请求示例**
{
  "feedbackId": "1",
  "feedbackCourseId": "1",
  "feedbackTitle": "课程问卷",
  "creatTime": "1969-12-31T23:59:59.000Z",
  "startTime": "1969-12-31T23:59:59.000Z",
  "endTime": "1969-12-31T23:59:59.000Z",
  "questionList": [
      {
        "questionTitle": "今天课程的难度怎么样",
        "questionType": 0,
        "options": [
          "",
          "一般",
          "简单"
        ]
      },
      {
        "questionTitle": "请问你的hadoop配置完了哪些选项",
        "questionType": 1,
        "options": [
          "Hadoop+Hdfs",
          "Hadoop+Hbase",
          "Hadoop+Hbase+MongDB"
        ]
      },
      {
        "questionTitle": "你对课程有什么建议吗",
        "questionType": 2,
        "options": []
      }
    ]
}

返回示例

{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "feedbackId": "624277165955a67245505278",
    "feedbackCourseId": "1",
    "feedbackTitle": "课程问卷",
    "creatTime": "1969-12-31T23:59:59.000+00:00",
    "startTime": "1969-12-31T23:59:59.000+00:00",
    "endTime": "1969-12-31T23:59:59.000+00:00",
    "questionList": [
      {
        "questionTitle": "今天课程的难度怎么样",
        "questionType": 0,
        "options": [
          "",
          "一般",
          "简单"
        ]
      },
      {
        "questionTitle": "请问你的hadoop配置完了哪些选项",
        "questionType": 1,
        "options": [
          "Hadoop+Hdfs",
          "Hadoop+Hbase",
          "Hadoop+Hbase+MongDB"
        ]
      },
      {
        "questionTitle": "你对课程有什么建议吗",
        "questionType": 2,
        "options": []
      }
    ]
  }
}

deleteFeedback

基本信息

Path: /feedback/delete

Method: DELETE

**接口描述:**删除问卷

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded application/x-www-form-urlencoded
Query
参数名称 是否必须 示例 备注
id 1 问卷ID

返回数据

名称类型是否必须默认值备注其他信息
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功"
}

findByCourseId

基本信息

Path: /feedback/findByCourseId

Method: GET

**接口描述:**通过发布问卷的课程id查询问卷发布详情

请求参数

Query

参数名称 是否必须 示例 备注
courseId 1 课程ID

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": [
    {
      "feedbackId": "6242775d5955a67245505279",
      "feedbackCourseId": "624266105955a67245505275",
      "feedbackTitle": "JAVA课程问卷",
      "creatTime": "1969-12-31T23:59:59.000+00:00",
      "startTime": "1969-12-31T23:59:59.000+00:00",
      "endTime": "1969-12-31T23:59:59.000+00:00",
      "questionList": [
        {
          "questionTitle": "今天课程的难度怎么样",
          "questionType": 0,
          "options": [
            "",
            "一般",
            "简单"
          ]
        },
        {
          "questionTitle": "请问你的hadoop配置完了哪些选项",
          "questionType": 1,
          "options": [
            "Hadoop+Hdfs",
            "Hadoop+Hbase",
            "Hadoop+Hbase+MongDB"
          ]
        },
        {
          "questionTitle": "你对课程有什么建议吗",
          "questionType": 2,
          "options": []
        }
      ]
    }
  ]
}

findById

基本信息

Path: /feedback/findById

Method: GET

**接口描述:**通过发布问卷的id查询问卷详情

请求参数

Query

参数名称 是否必须 示例 备注
id 1 问卷ID

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "feedbackId": "624277165955a67245505278",
    "feedbackCourseId": "1",
    "feedbackTitle": "课程问卷",
    "creatTime": "1969-12-31T23:59:59.000+00:00",
    "startTime": "1969-12-31T23:59:59.000+00:00",
    "endTime": "1969-12-31T23:59:59.000+00:00",
    "questionList": [
      {
        "questionTitle": "今天课程的难度怎么样",
        "questionType": 0,
        "options": [
          "",
          "一般",
          "简单"
        ]
      },
      {
        "questionTitle": "请问你的hadoop配置完了哪些选项",
        "questionType": 1,
        "options": [
          "Hadoop+Hdfs",
          "Hadoop+Hbase",
          "Hadoop+Hbase+MongDB"
        ]
      },
      {
        "questionTitle": "你对课程有什么建议吗",
        "questionType": 2,
        "options": []
      }
    ]
  }
}

getAll

基本信息

Path: /feedback/getAll

Method: GET

**接口描述:**查看所有发布的问卷

请求参数

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**返回示例**
{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": [
    {
      "feedbackId": "624277165955a67245505278",
      "feedbackCourseId": "1",
      "feedbackTitle": "课程问卷",
      "creatTime": "1969-12-31T23:59:59.000+00:00",
      "startTime": "1969-12-31T23:59:59.000+00:00",
      "endTime": "1969-12-31T23:59:59.000+00:00",
      "questionList": [
        {
          "questionTitle": "今天课程的难度怎么样",
          "questionType": 0,
          "options": [
            "",
            "一般",
            "简单"
          ]
        },
        {
          "questionTitle": "请问你的hadoop配置完了哪些选项",
          "questionType": 1,
          "options": [
            "Hadoop+Hdfs",
            "Hadoop+Hbase",
            "Hadoop+Hbase+MongDB"
          ]
        },
        {
          "questionTitle": "你对课程有什么建议吗",
          "questionType": 2,
          "options": []
        }
      ]
    },
    {
      "feedbackId": "6242775d5955a67245505279",
      "feedbackCourseId": "1",
      "feedbackTitle": "课程问卷",
      "creatTime": "1969-12-31T23:59:59.000+00:00",
      "startTime": "1969-12-31T23:59:59.000+00:00",
      "endTime": "1969-12-31T23:59:59.000+00:00",
      "questionList": [
        {
          "questionTitle": "今天课程的难度怎么样",
          "questionType": 0,
          "options": [
            "",
            "一般",
            "简单"
          ]
        },
        {
          "questionTitle": "请问你的hadoop配置完了哪些选项",
          "questionType": 1,
          "options": [
            "Hadoop+Hdfs",
            "Hadoop+Hbase",
            "Hadoop+Hbase+MongDB"
          ]
        },
        {
          "questionTitle": "你对课程有什么建议吗",
          "questionType": 2,
          "options": []
        }
      ]
    }
  ]
}

updateFeedback

基本信息

Path: /feedback/update

Method: PUT

**接口描述:**修改问卷发布详情

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json application/json
Body
名称类型是否必须默认值备注其他信息
feedbackIdstring必须问卷ID
feedbackCourseIdstring必须问卷课程ID
feedbackTitlestring必须问卷标题
creatTimestring必须创建时间

mock: @datetime

startTimestring必须开始时间

mock: @datetime

endTimestring必须结束时间

mock: @datetime

questionListobject []必须问题列表

item 类型: object

├─ questionTitlestring必须问题标题
├─ questionTypeinteger必须问题类型(0:单选题,1:多选题,2:主观题)
├─ optionsstring []必须选项(列表长度:{0:主观题,1:单选题,2:多选题})

item 类型: string

├─ 非必须

返回数据

名称类型是否必须默认值备注其他信息
dataobject必须
rspCodestring必须200
rspMsgstring必须操作成功
**请求示例**
{
  "feedbackId": "624277165955a67245505278",
  "feedbackCourseId": "1",
  "feedbackTitle": "课程问卷",
  "creatTime": "2022-03-29T23:59:59.000Z",
  "startTime": "2022-03-29T23:59:59.000Z",
  "endTime": "2022-03-29T23:59:59.000Z",
  "questionList": [
      {
        "questionTitle": "请问你的hadoop配置完了哪些选项",
        "questionType": 1,
        "options": [
          "Hadoop+Hdfs",
          "Hadoop+Hbase",
          "Hadoop+Hbase+MongDB"
        ]
      },
      {
        "questionTitle": "你对课程有什么建议吗",
        "questionType": 2,
        "options": []
      }
    ]
}

返回示例

{
  "rspCode": "200",
  "rspMsg": "操作成功",
  "data": {
    "feedbackId": "624277165955a67245505278",
    "feedbackCourseId": "1",
    "feedbackTitle": "课程问卷",
    "creatTime": "2022-03-29T23:59:59.000+00:00",
    "startTime": "2022-03-29T23:59:59.000+00:00",
    "endTime": "2022-03-29T23:59:59.000+00:00",
    "questionList": [
      {
        "questionTitle": "请问你的hadoop配置完了哪些选项",
        "questionType": 1,
        "options": [
          "Hadoop+Hdfs",
          "Hadoop+Hbase",
          "Hadoop+Hbase+MongDB"
        ]
      },
      {
        "questionTitle": "你对课程有什么建议吗",
        "questionType": 2,
        "options": []
      }
    ]
  }
}