Skip to content

mengxun1437/oj

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
.idea
.idea
 
 
src/main
src/main
 
 
target
target
 
 
README.md
README.md
 
 
cxsjOj.iml
cxsjOj.iml
 
 
pom.xml
pom.xml
 
 

Repository files navigation

OJ系统后端API

报错信息表
错误码(code) 说明
0 success,如果有数据，看返回json数据中的”data"
40000 操作失败，具体原因看返回的"json"数据中的"msg"

一.教师

1.1教师注册

注意

账号2-6位，密码6-20位

接口

[PUT]http://mengxun.online/api/oj/teacher/

正确示例

{
    "name":"张三",
    "password":"zhangsan123456"
}

返回结果

{
    "code": 0,
    "msg": "教师注册成功",
    "data": {
        "UpdateAt": "2020-10-31T16:44:28.624+0000",
        "CreateAt": "2020-10-31T16:44:28.624+0000",
        "ID": "9d790ae2-034e-481e-853c-817d023f2986",
        "Name": "张三"
    }
}

错误案例

{
    "name":"张三",
    "password":"zhangsan123456"
}

返回结果

{
    "code": 40000,
    "msg": "用户名已经注册",
    "data": null
}

1.2教师登录

注意

账号2-6位，密码6-20位

接口

[POST]http://mengxun.online/api/oj/teacher/

正确示例

{
    "name":"张三",
    "password":"zhangsan123456"
}

返回结果

{
    "code": 0,
    "msg": "教师存在，登录成功",
    "data": {
        "UpdateAt": "2020-10-31T16:44:28.624+0000",
        "CreateAt": "2020-10-31T16:44:28.624+0000",
        "ID": "9d790ae2-034e-481e-853c-817d023f2986",
        "Name": "张三"
    }
}

错误示例

{
    "name":"张三",
    "password":"zhangsan12345"
}

返回结果

{
    "code": 40000,
    "msg": "教师密码错误",
    "data": null
}

1.3通过id获取教师的具体信息

接口

[GET]http://mengxun.online/api/oj/teacher/{id}

例

http://mengxun.online/api/oj/teacher/5322611b-3fb9-4c3d-adf9-af57f1fbe066

返回结果[正确]

{
    "code": 0,
    "msg": "success",
    "data": {
        "Email": null,
        "UpdateAt": "2020-11-04T06:48:42.000+0000",
        "CreateAt": "2020-11-04T06:48:42.000+0000",
        "Sex": null,
        "ID": "5322611b-3fb9-4c3d-adf9-af57f1fbe066",
        "Age": null,
        "Name": "wang"
    }
}

返回结果[错误]

{
    "code": 40000,
    "msg": "提供的教师id不存在",
    "data": null
}

1.4修改教师的某些信息

注意

​ 1.账号2-6位，密码6-20位，性别{0,1}，年龄[10,60]

​ 2.需要修改哪些信息，就在json数据中传哪些信息

接口

[PATCH]http://mengxun.online/api/oj/teacher/{id}

例

http://mengxun.online/api/oj/teacher/5322611b-3fb9-4c3d-adf9-af57f1fbe066

正确示例：假设只需修改密码

{
    "password":"wangwujun"
}

返回结果

{
    "code": 0,
    "msg": "教师信息修改成功",
    "data": {
        "Email": null,
        "UpdateAt": "2020-11-04T06:56:14.423+0000",
        "CreateAt": "2020-11-04T06:48:42.000+0000",
        "Sex": 0,
        "ID": "5322611b-3fb9-4c3d-adf9-af57f1fbe066",
        "Age": 18,
        "Name": "wujun1"
    }
}

错误示例

{
    "password":"wa"
}

返回结果

{
    "code": 40000,
    "msg": "用户密码长度错误",
    "data": null
}

二.学生

2.1学生注册

注意

账号2-6位，密码6-20位

接口

[PUT]http://mengxun.online/api/oj/student/

正确示例

{
    "name":"李四",
    "password":"lisi123456"
}

返回结果

{
    "code": 0,
    "msg": "学生注册成功",
    "data":{
        "UpdateAt": "2020-10-31T16:44:28.624+0000",
        "CreateAt": "2020-10-31T16:44:28.624+0000",
        "ID": "9d790ae2-034e-481e-853c-817d023f2986",
        "Name": "李四"
    }
}

错误案例

{
    "name":"李四",
    "password":"zhangsan123"
}

返回结果

{
    "code": 40000,
    "msg": "用户名已经注册",
    "data": null
}

2.2学生登录

注意

账号2-6位，密码6-20位

接口

[POST]http://mengxun.online/api/oj/student/

正确示例

{
    "name":"李四",
    "password":"zhangsan123456"
}

返回结果

{
    "code": 0,
    "msg": "学生存在，登录成功",
    "data": {
        "UpdateAt": "2020-10-31T16:44:28.624+0000",
        "CreateAt": "2020-10-31T16:44:28.624+0000",
        "ID": "9d790ae2-034e-481e-853c-817d023f2986",
        "Name": "李四"
    }
}

错误示例

{
    "name":"李四",
    "password":"lisi1234"
}

返回结果

{
    "code": 40000,
    "msg": "用户密码错误",
    "data": null
}

2.3通过id获取学生的具体信息

接口

[GET]http://mengxun.online/api/oj/student/{id}

例

http://mengxun.online/api/oj/student/4a379f0a-28ae-4937-9fc4-c5366bb6cb76

返回结果[正确]

{
    "code": 0,
    "msg": "success",
    "data": {
        "Email": null,
        "UpdateAt": "2020-11-04T06:59:42.000+0000",
        "CreateAt": "2020-11-04T06:59:42.000+0000",
        "ID": "4a379f0a-28ae-4937-9fc4-c5366bb6cb76",
        "Name": "hahaha"
    }
}

返回结果[错误]

{
    "code": 40000,
    "msg": "提供的学生id不存在",
    "data": null
}

2.4修改学生的某些信息

注意

​ 1.账号2-6位，密码6-20位

​ 2.需要修改哪些信息，就在json数据中传哪些信息

接口

[PATCH]http://mengxun.online/api/oj/student/{id}

例

http://mengxun.online/api/oj/student/4a379f0a-28ae-4937-9fc4-c5366bb6cb76

正确示例：假设只需修改密码

{
    "password":"wangwujun"
}

返回结果

{
    "code": 0,
    "msg": "学生信息修改成功",
    "data": {
        "Email": null,
        "UpdateAt": "2020-11-04T07:01:45.932+0000",
        "CreateAt": "2020-11-04T06:59:42.000+0000",
        "ID": "4a379f0a-28ae-4937-9fc4-c5366bb6cb76",
        "Name": "hahaha"
    }
}

错误示例

{
    "password":"wa"
}

返回结果

{
    "code": 40000,
    "msg": "用户密码长度错误",
    "data": null
}

三.题目

3.1增加一个新的题目

注意

​ 1.提交参数的json中必须由name/detail/creator/diff这四个参数

​ 2.如果由代码样例需要code（base64形式）,提交code的时候必须加入codetype(代码文件类型)

​ 3.diff是题目难度，可选参数0/1/2，整数形式提交

接口

[PUT]http://mengxun.online/api/oj/question/

正确示例

{
    "name":"题目一",
    "detail":"题目一的描述",
    "creator":"df7e5a0c-8920-45a2-b92a-604d66e95e48",
    "diff":2,
 "code":"ewogICAgIm5hbWUiOiLnjovmrabkv4oiLAogICAgInBhc3N3b3JkIjoid2FuZ3d1anVuIgp9Cg==",
    "codetype":"json"
}

返回结果

{
    "code": 0,
    "msg": "保存成功",
    "data": {
        "UpdateAt": "2020-11-05T12:11:45.567+0000",
        "TestData": "",
        "CreateAt": "2020-11-05T12:11:45.567+0000",
        "Diff": 2,
        "ID": "f7a6878b-7265-4a04-8095-4629328a2159",
        "Creator": "df7e5a0c-8920-45a2-b92a-604d66e95e48",
        "Detail": "题目一的描述",
        "Name": "题目一"
    }
}

错误案例

{
    "name":"题目一",
    "detail":"题目一的描述",
    "creator":"df7e5a0c-8920-45a2-b92a-604d66e95e48",
    "diff":2,
    "code":"ewogICAgIm5hbWUiOiLnjovmrabkv4oiLAogICAgInBhc3N3b3JkIjoid2FuZ3d1anVuIgp9Cg=="
}

返回结果

{
    "code": 40000,
    "msg": "codetype参数缺失",
    "data": null
}

3.2查看某个题目的具体信息

注意

​ 1.必须指定请求者的身份teacher/student

​ 2.如果需要获取这一题的代码样例，需要指定获取代码样例的文件类型（codetype)，不需要的话可以不写

接口

[POST]http://mengxun.online/api/oj/question/{id}

例

http://mengxun.online/api/oj/question/f7a6878b-7265-4a04-8095-4629328a2159

正确案例

{
   "identity":"student",
   "codetype":"json"
}

返回结果

{
    "code": 0,
    "msg": "题目存在",
    "data": {
        "UpdateAt": "2020-11-05T12:11:45.000+0000",
        "code": "ewogICAgIm5hbWUiOiLnjovmrabkv4oiLAogICAgInBhc3N3b3JkIjoid2FuZ3d1anVuIgp9Cg==",
        "CreateAt": "2020-11-05T12:11:45.000+0000",
        "Diff": 2,
        "codetype": "json",
        "ID": "f7a6878b-7265-4a04-8095-4629328a2159",
        "Creator": "df7e5a0c-8920-45a2-b92a-604d66e95e48",
        "Detail": "题目一的描述",
        "Name": "题目一"
    }
}

错误案例

{
   "codetype":"json"
}

返回结果

{
    "code": 40000,
    "msg": "必须说明用户身份：teacher/student",
    "data": null
}

3.3修改题目的某些信息

注意

​ 1.必须提交教师的id（json中的creator）

​ 2.需要修改哪些信息就在json中写哪些信息，如果需要添加codetype不同的代码样例，也可以通过这个接口

接口

[PATCH]http://mengxun.online/api/oj/question/{id}

例

http://mengxun.online/api/oj/question/f7a6878b-7265-4a04-8095-4629328a2159

正确案例

{
    "creator":"df7e5a0c-8920-45a2-b92a-604d66e95e48",
    "name":"题目更改后"
}

返回结果

{
    "code": 0,
    "msg": "修改题目信息成功",
    "data": null
}

错误案例

{
    "name":"题目更改后"
}

返回结果

{
    "code": 40000,
    "msg": "creator参数缺失",
    "data": null
}

3.4删除某一题目

注意

​ 1.必须提交教师的id(json中的creator)

​ 2.删除的同时会删除教师关于这道题发布的所有类型的代码案例

接口

[DELETE]http://mengxun.online/api/oj/question/{id}

例

http://mengxun.online/api/oj/question/b5aee93a-d47a-479a-adb6-a1e625fd7e8e

正确案例

{
    "creator":"df7e5a0c-8920-45a2-b92a-604d66e95e48" 
}

返回结果

{
    "code": 0,
    "msg": "删除题目成功",
    "data": null
}

错误案例

{
    "creator":"df7e5a0c-8920-45a2-b92a-604d66e9" 
}

返回结果

{
    "code": 40000,
    "msg": "用户校验失败",
    "data": null
}

3.5获取题目列表

注意

​ 1.需要指定获取列表者的身份（identity:teacher/student)

​ 2.如果指定的身份是teacher,需要指定creator(教师获取自己发布的题目时候用),如果是学生，则不需要，通过接口获得的是所有的题目列表

接口

[POST]http://mengxun.online/api/oj/question/list

正确案例

{
   "identity":"teacher",
   "creator":"df7e5a0c-8920-45a2-b92a-604d66e95e48"
}

返回结果

{
    "code": 0,
    "msg": "success",
    "data": [
        {
            "UpdateAt": "2020-11-05T11:58:18.000+0000",
            "CreateAt": "2020-11-05T11:58:18.000+0000",
            "Diff": 2,
            "ID": "3cc5e621-94f9-45be-beb0-61c503c7a8e8",
            "Name": "json"
        },
        {
            "UpdateAt": "2020-11-05T11:59:05.000+0000",
            "CreateAt": "2020-11-05T11:59:05.000+0000",
            "Diff": 2,
            "ID": "aaf9567e-2a16-4956-a37c-93995f1660de",
            "Name": "json"
        },
        {
            "UpdateAt": "2020-11-05T12:11:45.000+0000",
            "CreateAt": "2020-11-05T12:11:45.000+0000",
            "Diff": 2,
            "ID": "f7a6878b-7265-4a04-8095-4629328a2159",
            "Name": "题目一"
        },
        {
            "UpdateAt": "2020-11-05T12:16:48.000+0000",
            "CreateAt": "2020-11-05T12:16:48.000+0000",
            "Diff": 2,
            "ID": "588fb8be-ddb5-4a27-861d-e8226051625b",
            "Name": "题目一"
        },
        {
            "UpdateAt": "2020-11-09T08:00:03.000+0000",
            "CreateAt": "2020-11-09T07:57:07.000+0000",
            "Diff": 2,
            "ID": "b7783a75-6765-4fd8-8c4a-f29e5149583c",
            "Name": "题目更改后"
        },
        {
            "UpdateAt": "2020-11-11T04:22:07.000+0000",
            "CreateAt": "2020-11-11T04:22:07.000+0000",
            "Diff": 2,
            "ID": "228f685e-d1b1-43fa-88bf-b37b022a6747",
            "Name": "题目一"
        }
    ]
}

错误案例

{
   "identity":"teacher"
}

返回结果

{
    "code": 40000,
    "msg": "教师身份查询需指明creator",
    "data": null
}

3.6增加或修改一个题目的测试数据

注意

​ API中的id是这道题目的唯一标识id

​ testdata中是json数组，json的两个键为input和output,值为字符串形式上传

接口

[PUT] http://mengxun.online/api/oj/question/testdata/{id}

例

http://mengxun.online/api/oj/question/testdata/a2c32a15-c0b3-40a4-b9a3-07956ab2d9ac

正确案例

{
    "testdata":[
      {
        "input":"1 2",
        "output":"3"
      },
      {
        "input":"1 3",
        "output":"4"
      },
      {
        "input":"1 3",
        "output":"4"
      }
    ]
}

返回结果

{
    "code": 0,
    "msg": "更新题目测试数据成功",
    "data": null
}

错误案例

{
    
}

返回结果

{
    "code": 40000,
    "msg": "缺少testdata参数",
    "data": null
}

3.7获取某道题目的测试数据

注意

​ 1.没有做身份校验，最好只用老师身份来请求

​ 2.API中的id是这道题目的唯一标识id

接口

[GET] http://mengxun.online/api/oj/question/testdata/{id}

例

http://mengxun.online/api/oj/question/testdata/a2c32a15-c0b3-40a4-b9a3-07956ab2d9ac

返回结果

{
    "code": 0,
    "msg": "success",
    "data": [
        {
            "output": "3",
            "input": "1 2"
        },
        {
            "output": "4",
            "input": "1 3"
        },
        {
            "output": "4",
            "input": "1 3"
        }
    ]
}

四.代码

4.1代码运行

注意

​ 1.API中的id是题目的id

​ 2.需要提交3个参数 uid:请求者的id,code:代码文件的base64编码，codetype:代码类型（目前只支持C语言）

​ 3.返回结果有四种：编译失败/运行时出错/答案错误/通过

​ 4.返回的参数:memory:内存（B），time：运行时间（ms），profiller:运行的profiler文件，含有函数调用信息，需要base64解码

接口

[POST] http://mengxun.online/api/oj/run/{id}

正确案例

{
    "uid":"a2c32a15-c0b3-40a4-b9a3-07956ab2d9ac",
    "code":"I2luY2x1ZGU8c3RkaW8uaD4KCmludCBtYWluKCl7CiAgICBpbnQgYT0wLGI9MDsKICAgIHNjYW5mKCIlZCAlZCAlZCIsJmEsJmIpOwogICAgcHJpbnRmKCIlZCIsYStiKTsKICAgIHJldHVybiAwOwp9",
    "codetype":"c"

}

返回结果

{
    "code": 0,
    "msg": "运行通过",
    "data": {
         "Status": "Accepted",
         "Profiler": "dahajsdhasd",
         "Memory": "192392",
         "Time": "15"
    }
}

错误案例

{
    "code":"I2luY2x1ZGU8c3RkaW8uaD4KCmludCBtYWluKCl7CiAgICBpbnQgYT0wLGI9MDsKICAgIHNjYW5mKCIlZCAlZCAlZCIsJmEsJmIpOwogICAgcHJpbnRmKCIlZCIsYStiKTsKICAgIHJldHVybiAwOwp9",
    "codetype":"c"

}

返回结果

{
    "code": 40000,
    "msg": "没有提交操作人的id",
    "data": null
}

4.2代码保存

注意

​ 1.API中的id是提交者的id(学生id)

​ 2.需要提交的参数为qid:题目的id,code:代码,codetype:代码类型,state:代码通过状态,memory:代码运行内存(0)，time:代码运行时间(0)

接口

[PUT] http://mengxun.online/api/oj/code/{id}

例 http://mengxun.online/api/oj/code/4e59eb9b-910b-46f9-8bfb-62fd7927c5c5

正确案例：

{
    "code":"I2luY2x1ZGU8c3RkaW8uaD4KCmludCBtYWluKCl7CiAgICBpbnQgYT0wLGI9MDsKICAgIHNjYW5mKCIlZCAlZCAlZCIsJmEsJmIpOwogICAgcHJpbnRmKCIlZCIsYStiKTsKICAgIHJldHVybiAwOwp9",
    "codetype":"c",
    "qid":"a2c32a15-c0b3-40a4-b9a3-07956ab2d9ac",
    "state":"Accepted",
    "memory": "10000",
    "time": "12"
}

返回结果

{
    "code": 0,
    "msg": "success",
    "data": null
}

错误案例

{
    "code":"I2luY2x1ZGU8c3RkaW8uaD4KCmludCBtYWluKCl7CiAgICBpbnQgYT0wLGI9MDsKICAgIHNjYW5mKCIlZCAlZCAlZCIsJmEsJmIpOwogICAgcHJpbnRmKCIlZCIsYStiKTsKICAgIHJldHVybiAwOwp9",
    "codetype":"c"
}

4.3获取学生关于某一题的提交记录

注意

​ 1.API中的id是提交者的id(学生id)

​ 2.需要提交的参数为qid:题目的id

接口

[POST] http://mengxun.online/api/oj/code/{id}

例

http://mengxun.online/api/oj/code/4e59eb9b-910b-46f9-8bfb-62fd7927c5c5

正确案例

{
    "qid":"a2c32a15-c0b3-40a4-b9a3-07956ab2d9ac"
}

返回结果

{
    "code": 0,
    "msg": "success",
    "data": {
        "Versions": [
            "12ae82f267f9e73196fb611d276021197238f12f",
            "79308068a7250d847fcb38456940d49ac9199e3a"
        ],
        "ID": "4e59eb9b-910b-46f9-8bfb-62fd7927c5c5",
        "QID": "a2c32a15-c0b3-40a4-b9a3-07956ab2d9ac"
    }
}

错误案例

{
}

返回结果

{
    "code": 40000,
    "msg": "提交数据缺失",
    "data": null
}

4.4通过version版本号获取提交的代码

注意

​ 1.API中的id是提交者的id(学生id),version为提交记录中的版本号

​ 2.需要提交的参数为qid:题目的id

接口

[POST] http://mengxun.online/api/oj/code/{id}/{version}

例

http://mengxun.online/api/oj/code/4e59eb9b-910b-46f9-8bfb-62fd7927c5c5/79308068a7250d847fcb38456940d49ac9199e3a

正确案例

{
    "qid":"a2c32a15-c0b3-40a4-b9a3-07956ab2d9ac"
}

返回结果

{
    "code": 0,
    "msg": "success",
    "data": {
        "Version": "79308068a7250d847fcb38456940d49ac9199e3a",
        "ID": "4e59eb9b-910b-46f9-8bfb-62fd7927c5c5",
        "Code": "I2luY2x1ZGU8c3RkaW8uaD4KCmludCBtYWluKCl7CiAgICBpbnQgYT0wLGI9MDsKICAgIHNjYW5mKCIlZCAlZCAlZCIsJmEsJmIpOwogICAgcHJpbnRmKCIlZCIsYStiKTsKICAgIHJldHVybiAwOwp9",
        "Result": {
            "CodeType": "c",
            "AccessState": "Accepted",
            "Memory": "1000",
            "Time": "12"
        }
    }
}

错误案例

{
    
}

返回结果

{
    "code": 40000,
    "msg": "提交数据缺失",
    "data": null
}

<<<<<<< HEAD

五.考试

5.1教师增加一场考试

注意

​ 1.需要提交的参数：creator:教师id,name:考试名称，start:考试开始时间，end:考试结束时间，pub:是否向学生公开（0表示否，1表示是），qids:这次考试中的题目id(数组形式上传)

​ 2.start<end(后端有验证)

接口

[PUT] http://mengxun.online/api/oj/exam/

正确案例

{
    "creator":"5887577d-eb0c-408a-ad55-d82481a08e50",
    "name":"考试001",
    "start":"2020/11/19 00:00:12",
    "end":"2020/11/23 11:00:12",
    "pub":1,
    "qids":["6591bdf8-c04c-47c8-a2f2-0d8eceb04b9a","835d1423-2940-40de-8321-025d4b1fcdab","966daad8-e4ae-4ead-899e-ec2119fd8b2b"]
}

返回结果

{
    "code": 0,
    "msg": "保存考试成功",
    "data": {
        "UpdateAt": "2020-11-25T14:20:09.869+0000",
        "CreateAt": "2020-11-25T14:20:09.869+0000",
        "Start": "2020-11-18T16:00:12.000+0000",
        "End": "2020-11-23T03:00:12.000+0000",
        "ID": "6732bdf2-c352-4988-a885-3c3fc2c8147e",
        "Pub": 1,
        "Name": "考试001"
    }
}

错误案例

{
    "creator":"5887577d-eb0c-408a-ad55-d82481a08e50",
    "name":"考试001",
    "start":"2020/12/19 00:00:12",
    "end":"2020/11/23 11:00:12",
    "pub":1,
    "qids":["6591bdf8-c04c-47c8-a2f2-0d8eceb04b9a","835d1423-2940-40de-8321-025d4b1fcdab","966daad8-e4ae-4ead-899e-ec2119fd8b2b"]
}

返回结果

{
    "code": 40000,
    "msg": "时间先后错误",
    "data": null
}

5.2教师修改考试信息

注意

​ 1.api中的id是考试id唯一标识，是在增加新考试的时候返回的id

​ 2.必须上传的参数是creator:教师id，这个地方做了身份验证，需要传入发布考试的教师的id

​ 3.想修改什么就把什么传到json里面：name/pub/start/end/qids(提交start时候一定要提交end，不然算无效提交)

接口

[PATCH] http://mengxun.online/api/oj/exam/{id}

例

http://mengxun.online/api/oj/exam/dc238675-04b2-4d95-9065-408de7553054

正确案例

{
    "creator":"5887577d-eb0c-408a-ad55-d82481a08e50",
    "name":"测试学生提交",
    "pub":1
}

返回结果

{
    "code": 0,
    "msg": "修改考试信息成功",
    "data": null
}

错误案例

{
    "creator":"5887577d-eb",
    "name":"测试学生提交",
    "pub":1
}

返回结果

{
    "code": 40000,
    "msg": "creator不合法",
    "data": null
}

5.3教师删除某一个考试

注意

​ 1.api中的id是考试的唯一标识id

​ 2.需要上传的参数：creator:发布这个考试的教师的id(后端做了验证)

接口

[DELETE] http://mengxun.online/api/oj/exam/ {id}

例：

http://mengxun.online/api/oj/exam/5f4aec21-4b0f-4941-9032-941039db57bf

正确案例

{
     "creator":"5887577d-eb0c-408a-ad55-d82481a08e5"
}

返回结果

{
    "code": 0,
    "msg": "删除成功",
    "data": null
}

错误案例

{
     "creator":"5887577d-eb0c-408a-a"
}

返回结果

{
    "code": 40000,
    "msg": "用户校验不合法",
    "data": null
}

5.4获取所有属于自己的考试列表

注意

​ 1.需要提交的参数：identity:student/teacher(指明调用者的身份)，sid:学生id，如果是学生调用，需要，获取到的是自己所有的答题记录；cid:教师id，如果是教师调用，需要，获取的是教师发布的所有题目

​ 2.不同身份的人获取的内容是不同的（student->Commits,teacher->Publish)

接口

[POST]http://mengxun.online/api/oj/exam/list

正确案例--教师

{
    "identity":"teacher",
    "cid":"5887577d-eb0c-408a-ad55-d82481a08e50"
}

返回结果

{
    "code": 0,
    "msg": "success",
    "data": {
        "Publish": [
            "1d217967-b067-4f35-a01a-92f1708cd7ec",
            "1405dbd0-1287-4ede-9ed3-90a279167cab",
            "6732bdf2-c352-4988-a885-3c3fc2c8147e",
            "942fa393-bcaf-4b01-97ce-1136165d836a",
            "1e432f53-da80-46d1-b029-ac13f5c58960"
        ],
        "Cid": "5887577d-eb0c-408a-ad55-d82481a08e50"
    }
}

正确案例--学生

{
    "identity":"student",
    "sid":"715b7652-dca7-46fd-8df0-47b12ea4f41"
}

返回结果

{
    "code": 0,
    "msg": "success",
    "data": {
        "Commits": [
            "942fa393-bcaf-4b01-97ce-1136165d836a"
        ],
        "Sid": "715b7652-dca7-46fd-8df0-47b12ea4f41"
    }
}

错误案例

{
    "identity":"student"
}

返回结果

{
    "code": 40000,
    "msg": "sid参数缺失",
    "data": null
}

5.5通过id获取某场考试的详情

注意

​ 1.api中的id是考试的id

​ 2.需要提交的参数：identity(只能选择student或者teacher，指定获取者的身份) ​ 3.返回的State表示考试进行状态，0表示未开始，1表示进行中，2表示已结束

接口

[POST] http://mengxun.online/api/oj/exam/{id}

例

http://mengxun.online/api/oj/exam/1e432f53-da80-46d1-b029-ac13f5c58960

正确案例

{
    "identity":"teacher"
}

返回结果

{
    "code": 0,
    "msg": "success",
    "data": {
        "Qids": [
            "id"
        ],
        "UpdateAt": "2020-11-25T14:07:10.000+0000",
        "CreateAt": "2020-11-25T14:07:10.000+0000",
        "Start": "2020-11-18T16:00:12.000+0000",
        "State": 1,
        "End": "2020-12-23T03:00:12.000+0000",
        "ID": "1e432f53-da80-46d1-b029-ac13f5c58960",
        "Creator": "5887577d-eb0c-408a-ad55-d82481a08e50",
        "Pub": 1,
        "Name": "考试001"
    }
}

错误案例

{

}

返回结果

{
    "code": 40000,
    "msg": "identity参数缺失",
    "data": null
}

5.6学生提交考试结果

注意

​ 1.api中的id是考试的唯一id（后端做了验证）

​ 2.必须提交的参数：sid:学生的唯一标识id,commit:提交的内容（说明，以数组形式上传，数组中可以存json类型，json中的参数自己决定，上传是啥，下次获取的就是啥）/commit长度必须时这次考试的题目数（后端做了验证）

接口

[POST] http://mengxun.online/api/oj/exam/stu/{id}

例

http://mengxun.online/api/oj/exam/stu/22c7aff6-e784-4881-8809-84dd4015f90c

正确案例

{
    "sid":"715b7652-dca7-46fd-8df0-47b12ea4f41",
    "commit":[
        {
           "eg":"这里和下面的json中的主键自己定义，需要传啥就自己定义，下次获取的就是你这次传的样子"
        },{
           
        },{

        }
        ]
}

返回结果

{
    "code": 0,
    "msg": "提交成功",
    "data": null
}

错误案例

{
    "sid":"715b7652-dca7-46fd-8df0-47b12ea4f41",
    "commit":[
        {
           "eg":"这里和下面的json中的主键自己定义，需要传啥就自己定义，下次获取的就是你这次传的样子"
        }]
}

返回结果

{
    "code": 40000,
    "msg": "考试提交题目数量不一致",
    "data": null
}

5.7教师查看某一次考试的提交者列表

注意

​ 1.api中的id是考试的唯一id

​ 2.需要参数：cid:教师的id（有权限验证）

接口

[POST] http://mengxun.online/api/oj/exam/commit/{id}

例

http://mengxun.online/api/oj/exam/commit/942fa393-bcaf-4b01-97ce-1136165d836a

正确案例

{
    "cid":"5887577d-eb0c-408a-ad55-d82481a08e50"
}

返回结果

{
    "code": 0,
    "msg": "success",
    "data": {
        "Answerd": [
            "715b7652-dca7-46fd-8df0-47b12ea4f41"
        ],
        "Eid": "942fa393-bcaf-4b01-97ce-1136165d836a"
    }
}

错误案例

{
    "cid":"5887577"
}

返回结果

{
    "code": 40000,
    "msg": "教师身份不合法",
    "data": null
}

5.8学生获取所有公开的考试列表

注意

​ 这个接口返回的是所有老师布置的考试中公开的部分，也是前端一开始需要的

接口

[GET] http://mengxun.online/api/oj/exam/

返回结果

{
    "code": 0,
    "msg": "success",
    "data": [
        {
            "Eid": "1405dbd0-1287-4ede-9ed3-90a279167cab",
            "UpdateAt": "2020-11-25T14:51:26.000+0000",
            "CreateAt": "2020-11-25T14:51:26.000+0000",
            "Creator": "5887577d-eb0c-408a-ad55-d82481a08e50",
            "Name": "考试001"
        },
        {
            "Eid": "1d217967-b067-4f35-a01a-92f1708cd7ec",
            "UpdateAt": "2020-11-25T14:06:46.000+0000",
            "CreateAt": "2020-11-25T14:06:46.000+0000",
            "Creator": "5887577d-eb0c-408a-ad55-d82481a08e50",
            "Name": "考试002"
        },
        {
            "Eid": "1e432f53-da80-46d1-b029-ac13f5c58960",
            "UpdateAt": "2020-11-25T14:07:10.000+0000",
            "CreateAt": "2020-11-25T14:07:10.000+0000",
            "Creator": "5887577d-eb0c-408a-ad55-d82481a08e50",
            "Name": "考试001"
        },
        {
            "Eid": "6732bdf2-c352-4988-a885-3c3fc2c8147e",
            "UpdateAt": "2020-11-25T14:20:09.000+0000",
            "CreateAt": "2020-11-25T14:20:09.000+0000",
            "Creator": "5887577d-eb0c-408a-ad55-d82481a08e50",
            "Name": "考试001"
        },
        {
            "Eid": "942fa393-bcaf-4b01-97ce-1136165d836a",
            "UpdateAt": "2020-11-25T15:48:17.000+0000",
            "CreateAt": "2020-11-25T15:48:17.000+0000",
            "Creator": "5887577d-eb0c-408a-ad55-d82481a08e50",
            "Name": "考试001"
        }
    ]
}

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

3 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Languages