Skip to content
GitLab

原始数据查询 · Changes

Page history
更新 原始数据查询.md authored by 唐宇's avatar 唐宇
Show whitespace changes
Inline Side-by-side
原始数据查询.md
View page @ 702ff8a4
......@@ -15,7 +15,7 @@
查询参数：
| 参数名 | 参数类型 | 参数含义 |
| ------ | ------ | ------ |
|------|--------|------|
| name | String | 课程名 |
返回值类型： String，表示课程对应的id
......@@ -36,7 +36,7 @@ JSON数组，数组中每个元素表示下一级的子团体或学生id。数
# 查询课程包含的学习内容id列表
全体内容包括这些类型：题目、作业、考试、在线实验、在线课堂（MOOC）、答疑（论坛）、科研等。
课程所含学习内容包括：题目、作业、考试、在线实验、在线课堂（MOOC）、答疑（论坛）、科研等。
服务请求地址：/query/course/resources_metadata
......@@ -73,7 +73,7 @@ JSON数组，数组中每个元素表示下一级的子团体或学生id。数
# 查询课程包含的学习内容详细情况
全体内容包括这些类型：题目、作业、考试、在线实验、在线课堂（MOOC）、答疑（论坛）、科研等。
课程所含学习内容包括：题目、作业、考试、在线实验、在线课堂（MOOC）、答疑（论坛）、科研等。
服务请求地址：/query/course/resources_detail
......@@ -85,9 +85,9 @@ JSON数组，数组中每个元素表示下一级的子团体或学生id。数
返回值类型：
Map<String, List<ActivityResult>>对应的JSON，表示不同学习内容类型及相应的学习内容详细信息。ActivityResult的数据结构可参考[学习内容查询结果的数据结构](附录#学习内容查询结果的数据结构)。
JSON对象，表示不同学习内容类型及相应的学习内容详细信息。其中，属性名为学习内容类型（可参考[学习内容类型分类及在JSON中的表示](附录#学习内容类型分类及在json中的表示)），属性值为JSON对象数组，该数组元素的数据结构可参考[学习内容查询结果的数据结构](附录#学习内容查询结果的数据结构)。
返回值包含了表示所含学习内容类型及相应的内容，其中学习内容类型可参考[学习内容类型分类及在JSON中的表示](附录#学习内容类型分类及在json中的表示)，相应学习内容的数据结构可参考[学习内容查询结果的数据结构](附录#学习内容查询结果的数据结构)。下面是一个返回值实例的缩略内容（此处仅展示data属性内容）。
下面是一个返回值实例的缩略内容（此处仅展示data属性内容）。
```
{
......@@ -130,7 +130,7 @@ Map<String, List<ActivityResult>>对应的JSON，表示不同学习内容类型
{"course":["1"],"homework_question":["10","11","12"]}
```
返回值相关信息可参考[查询课程包含的学习内容详细情况]（#查询课程包含的学习内容详细情况）。若返回的学习内容个数小于查询参数里的查询个数，说明部分要查询的学习内容为空。
返回值相关格式信息可参考[查询课程包含的学习内容详细情况]（#查询课程包含的学习内容详细情况）。若返回的学习内容个数小于查询参数里的查询个数，说明部分要查询的学习内容为空。
# 查询某作业题目指定学生集合的完成情况
......@@ -139,16 +139,16 @@ Map<String, List<ActivityResult>>对应的JSON，表示不同学习内容类型
查询参数：
| 参数名 | 参数类型 | 参数含义 |
|----------|--------------|---------------------------------|
|----------|----------|---------------------------------|
| id | String | 题目id |
| students | JSON数组 | 数组中每个元素为字符串格式的学生id或团体id |
| students | String数组 | 数组中每个元素为字符串格式的学生id或团体id，如20220103,20220104 |
| type | int | 查询类型（选填），详情可查看[查询类型对学习完成情况查询的影响](附录#不同查询类型对学习完成情况查询的影响) |
返回值类型：
返回值数据格式：
Map<String, List<StatementResult>> 对应的JSON，表示学生及相应的题目完成情况。StatementResult的数据结构可参考[学习内容完成情况数据结构](附录#学习内容完成情况-statementresult-数据结构)。
JSON对象，表示学生及相应的题目完成情况。其中，属性名为学生id，属性值为JSON对象数组，数组中元素的数据结构可参考[学习内容完成情况数据结构](附录#学习内容完成情况-statementresult-数据结构)。
# 查询某竞赛题目指定学生集合的完成情况
# 查询某考试题目指定学生集合的完成情况
服务请求地址：/query/exam_question/detail
......@@ -157,12 +157,10 @@ Map<String, List<StatementResult>> 对应的JSON，表示学生及相应的题
| 参数名 | 参数类型 | 参数含义 |
|----------|--------------|---------------------------------|
| id | String | 试题id |
| students | JSON数组 | 数组中每个元素为字符串格式的学生id或团体id |
| students | String数组 | 数组中每个元素为字符串格式的学生id或团体id，如20220103,20220104 |
| type | int | 查询类型（选填），详情可查看[查询类型对学习完成情况查询的影响](附录#不同查询类型对学习完成情况查询的影响) |
返回值类型：
Map<String, List<StatementResult>> 对应的JSON，表示学生及相应的题目完成情况。StatementResult的数据结构可参考[学习内容完成情况数据结构](附录#学习内容完成情况-statementresult-数据结构)。
返回的数据表示学生及相应的题目完成情况。数据格式可参考[查询某作业题目指定学生集合的完成情况](#查询某作业题目指定学生集合的完成情况)。
# 查询某作业指定学生集合的完成情况
......@@ -173,12 +171,10 @@ Map<String, List<StatementResult>> 对应的JSON，表示学生及相应的题
| 参数名 | 参数类型 | 参数含义 |
|----------|--------------|---------------------------------|
| id | String | 作业id |
| students | JSON数组 | 数组中每个元素为字符串格式的学生id或团体id |
| students | String数组 | 数组中每个元素为字符串格式的学生id或团体id，如20220103,20220104 |
| type | int | 查询类型（选填），详情可查看[查询类型对学习完成情况查询的影响](附录#不同查询类型对学习完成情况查询的影响) |
返回值类型：
Map<String, List<StatementResult>> 对应的JSON，表示学生及相应的作业完成情况。StatementResult的数据结构可参考[学习内容完成情况数据结构](附录#学习内容完成情况-statementresult-数据结构)。
返回的数据表示学生及相应的作业完成情况。返回数据的格式可参考[查询某作业题目指定学生集合的完成情况](#查询某作业题目指定学生集合的完成情况)。
# 查询某竞赛指定学生集合的完成情况
......@@ -195,12 +191,12 @@ Map<String, List<StatementResult>> 对应的JSON，表示学生及相应的作
| 参数名 | 参数类型 | 参数含义 |
|----------|--------------|---------------------------------|
| id | String | 考试id |
| students | JSON数组 | 数组中每个元素为字符串格式的学生id或团体id |
| students | String数组 | 数组中每个元素为字符串格式的学生id或团体id，如20220103,20220104 |
| type | int | 查询类型（选填），详情可查看[查询类型对学习完成情况查询的影响](附录#不同查询类型对学习完成情况查询的影响) |
返回值类型：
Map<String, List<StatementResult>> 对应的JSON，表示学生及相应考试完成情况。StatementResult的数据结构可参考[学习内容完成情况数据结构](附录#学习内容完成情况-statementresult-数据结构)。
返回的数据表示学生及相应的考试完成情况。返回数据的格式可参考[查询某作业题目指定学生集合的完成情况](#查询某作业题目指定学生集合的完成情况)。
# 查询某在线实验步骤指定学生集合的完成情况
......@@ -211,12 +207,10 @@ Map<String, List<StatementResult>> 对应的JSON，表示学生及相应考试
| 参数名 | 参数类型 | 参数含义 |
|----------|--------------|---------------------------------|
| id | String | 实验步骤id |
| students | JSON数组 | 数组中每个元素为字符串格式的学生id或团体id |
| students | String数组 | 数组中每个元素为字符串格式的学生id或团体id，如20220103,20220104 |
| type | int | 查询类型（选填），详情可查看[查询类型对学习完成情况查询的影响](附录#不同查询类型对学习完成情况查询的影响) |
返回值类型：
Map<String, List<StatementResult>> 对应的JSON，表示学生及相应实验完成情况。StatementResult的数据结构可参考[学习内容完成情况数据结构](附录#学习内容完成情况-statementresult-数据结构)。
返回的数据表示学生及相应的实验步骤完成情况。返回数据的格式可参考[查询某作业题目指定学生集合的完成情况](#查询某作业题目指定学生集合的完成情况)。
# 查询某在线实验指定学生集合的完成情况
......@@ -227,12 +221,10 @@ Map<String, List<StatementResult>> 对应的JSON，表示学生及相应实验
| 参数名 | 参数类型 | 参数含义 |
|----------|--------------|---------------------------------|
| id | String | 实验id |
| students | JSON数组 | 数组中每个元素为字符串格式的学生id或团体id |
| students | String数组 | 数组中每个元素为字符串格式的学生id或团体id，如20220103,20220104 |
| type | int | 查询类型（选填），详情可查看[查询类型对学习完成情况查询的影响](附录#不同查询类型对学习完成情况查询的影响) |
返回值类型：
Map<String, List<StatementResult>> 对应的JSON，表示学生及相应实验完成情况。StatementResult的数据结构可参考[学习内容完成情况数据结构](附录#学习内容完成情况-statementresult-数据结构)。
返回的数据表示学生及相应的实验完成情况。返回数据的格式可参考[查询某作业题目指定学生集合的完成情况](#查询某作业题目指定学生集合的完成情况)。
# 查询某在线实验作业指定学生集合的完成情况
......@@ -243,12 +235,10 @@ Map<String, List<StatementResult>> 对应的JSON，表示学生及相应实验
| 参数名 | 参数类型 | 参数含义 |
|----------|--------------|---------------------------------|
| id | String | 实验作业id |
| students | JSON数组 | 数组中每个元素为字符串格式的学生id或团体id |
| students | String数组 | 数组中每个元素为字符串格式的学生id或团体id，如20220103,20220104 |
| type | int | 查询类型（选填），详情可查看[查询类型对学习完成情况查询的影响](附录#不同查询类型对学习完成情况查询的影响) |
返回值类型：
Map<String, List<StatementResult>> 对应的JSON，表示学生及相应实验作业完成情况。StatementResult的数据结构可参考[学习内容完成情况数据结构](附录#学习内容完成情况-statementresult-数据结构)。
返回的数据表示学生及相应的实验作业完成情况。返回数据的格式可参考[查询某作业题目指定学生集合的完成情况](#查询某作业题目指定学生集合的完成情况)。
# 查询某在线课堂视频指定学生的观看情况
......@@ -259,12 +249,10 @@ Map<String, List<StatementResult>> 对应的JSON，表示学生及相应实验
| 参数名 | 参数类型 | 参数含义 |
|----------|--------------|---------------------------------|
| id | String | 在线课堂视频id |
| students | JSON数组 | 数组中每个元素为字符串格式的学生id或团体id |
| students | String数组 | 数组中每个元素为字符串格式的学生id或团体id，如20220103,20220104 |
| type | int | 查询类型（选填），详情可查看[查询类型对学习完成情况查询的影响](附录#不同查询类型对学习完成情况查询的影响) |
返回值类型：
Map<String, List<StatementResult>> 对应的JSON，表示学生及相应视频观看情况。StatementResult的数据结构可参考[学习内容完成情况数据结构](附录#学习内容完成情况-statementresult-数据结构)。
返回的数据表示学生及相应的在线课堂视频观看情况。返回数据的格式可参考[查询某作业题目指定学生集合的完成情况](#查询某作业题目指定学生集合的完成情况)。
# 查询某论坛主题指定学生集合的发帖情况
......@@ -275,12 +263,10 @@ Map<String, List<StatementResult>> 对应的JSON，表示学生及相应视频
| 参数名 | 参数类型 | 参数含义 |
|----------|--------------|---------------------------------|
| id | String | 论坛id |
| students | JSON数组 | 数组中每个元素为字符串格式的学生id或团体id |
| students | String数组 | 数组中每个元素为字符串格式的学生id或团体id，如20220103,20220104 |
| type | int | 查询类型（选填），详情可查看[查询类型对学习完成情况查询的影响](附录#不同查询类型对学习完成情况查询的影响) |
返回值类型：
Map<String, List<StatementResult>> 对应的JSON，表示学生及相应论坛主题下发帖情况。StatementResult的数据结构可参考[学习内容完成情况数据结构](附录#学习内容完成情况-statementresult-数据结构)。
返回的数据表示学生及相应的论坛主题内发帖情况。返回数据的格式可参考[查询某作业题目指定学生集合的完成情况](#查询某作业题目指定学生集合的完成情况)。
# 查询某论坛指定学生集合的发帖情况
......@@ -291,12 +277,10 @@ Map<String, List<StatementResult>> 对应的JSON，表示学生及相应论坛
| 参数名 | 参数类型 | 参数含义 |
|----------|--------------|---------------------------------|
| id | String | 论坛id |
| students | JSON数组 | 数组中每个元素为字符串格式的学生id或团体id |
| students | String数组 | 数组中每个元素为字符串格式的学生id或团体id，如20220103,20220104 |
| type | int | 查询类型（选填），详情可查看[查询类型对学习完成情况查询的影响](附录#不同查询类型对学习完成情况查询的影响) |
返回值类型：
Map<String, List<StatementResult>> 对应的JSON，表示学生及相应论坛发帖情况。StatementResult的数据结构可参考[学习内容完成情况数据结构](附录#学习内容完成情况-statementresult-数据结构)。
返回的数据表示学生及在相应论坛的发帖情况。返回数据的格式可参考[查询某作业题目指定学生集合的完成情况](#查询某作业题目指定学生集合的完成情况)。
# 查询某科研项目指定学生集合的使用情况
......@@ -307,12 +291,10 @@ Map<String, List<StatementResult>> 对应的JSON，表示学生及相应论坛
| 参数名 | 参数类型 | 参数含义 |
|----------|--------------|---------------------------------|
| id | String | 科研项目id |
| students | JSON数组 | 数组中每个元素为字符串格式的学生id或团体id |
| students | String数组 | 数组中每个元素为字符串格式的学生id或团体id，如20220103,20220104 |
| type | int | 查询类型（选填），详情可查看[查询类型对学习完成情况查询的影响](附录#不同查询类型对学习完成情况查询的影响) |
返回值类型：
Map<String, List<StatementResult>> 对应的JSON，表示学生及相应科研项目情况。StatementResult的数据结构可参考[学习内容完成情况数据结构](附录#学习内容完成情况-statementresult-数据结构)。
返回的数据表示学生及相应的科研环境使用情况。返回数据的格式可参考[查询某作业题目指定学生集合的完成情况](#查询某作业题目指定学生集合的完成情况)。
# 查询指定学生集合某Git仓库代码提交情况
......@@ -323,12 +305,10 @@ Map<String, List<StatementResult>> 对应的JSON，表示学生及相应科研
| 参数名 | 参数类型 | 参数含义 |
|----------|--------------|---------------------------------|
| id | String | Git 仓库id |
| students | JSON数组 | 数组中每个元素为字符串格式的学生id或团体id |
| students | String数组 | 数组中每个元素为字符串格式的学生id或团体id，如20220103,20220104 |
| type | int | 查询类型（选填），详情可查看[查询类型对学习完成情况查询的影响](附录#不同查询类型对学习完成情况查询的影响) |
返回值类型：
Map<String, List<StatementResult>> 对应的JSON，表示学生及相应git项目代码提交情况。StatementResult的数据结构可参考[学习内容完成情况数据结构](附录#学习内容完成情况-statementresult-数据结构)。
返回的数据表示学生及相应Git仓库代码提交情况。返回数据的格式可参考[查询某作业题目指定学生集合的完成情况](#查询某作业题目指定学生集合的完成情况)。
# 查询指定学生集合Git代码提交情况
......@@ -339,12 +319,10 @@ Map<String, List<StatementResult>> 对应的JSON，表示学生及相应git项
| 参数名 | 参数类型 | 参数含义 |
|----------|--------------|---------------------------------|
| id | String | Git commit标识 |
| students | JSON数组 | 数组中每个元素为字符串格式的学生id或团体id |
| students | String数组 | 数组中每个元素为字符串格式的学生id或团体id，如20220103,20220104 |
| type | int | 查询类型（选填），详情可查看[查询类型对学习完成情况查询的影响](附录#不同查询类型对学习完成情况查询的影响) |
返回值类型：
Map<String, List<StatementResult>> 对应的JSON，表示学生及相应git项目代码提交情况。StatementResult的数据结构可参考[学习内容完成情况数据结构](附录#学习内容完成情况-statementresult-数据结构)。
返回的数据表示学生及相应Git代码提交情况。返回数据的格式可参考[查询某作业题目指定学生集合的完成情况](#查询某作业题目指定学生集合的完成情况)。
# 查询指定学生集合的毕设完成情况
......@@ -355,28 +333,10 @@ Map<String, List<StatementResult>> 对应的JSON，表示学生及相应git项
| 参数名 | 参数类型 | 参数含义 |
|----------|--------------|---------------------------------|
| id | String | 毕设标识 |
| students | JSON数组 | 数组中每个元素为字符串格式的学生id或团体id |
| type | int | 查询类型（选填），详情可查看[查询类型对学习完成情况查询的影响](附录#不同查询类型对学习完成情况查询的影响) |
返回值类型：
Map<String, List<StatementResult>> 对应的JSON，表示学生及相应毕设完成情况。StatementResult的数据结构可参考[学习内容完成情况数据结构](附录#学习内容完成情况-statementresult-数据结构)。
# 查询指定学习内容集合里指定学生集合的完成情况
服务请求地址：/query/activity_student/detail
查询参数：
| 参数名 | 参数类型 | 参数含义 |
|------------|--------------|---------------------------------|
| activities | JSON数组 | 学习内容的id集合 |
| students | JSON数组 | 数组中每个元素为字符串格式的学生id或团体id |
| students | String数组 | 数组中每个元素为字符串格式的学生id或团体id，如20220103,20220104 |
| type | int | 查询类型（选填），详情可查看[查询类型对学习完成情况查询的影响](附录#不同查询类型对学习完成情况查询的影响) |
返回值类型：
Map<String, Map<String, List<StatementResult>>> 对应的JSON，表示指定的每个学习活动中，某个学生的完成情况。StatementResult的数据结构可参考[学习内容完成情况数据结构](附录#学习内容完成情况-statementresult-数据结构)。
返回的数据表示学生及相应的毕设完成情况。返回数据的格式可参考[查询某作业题目指定学生集合的完成情况](#查询某作业题目指定学生集合的完成情况)。
# 学生附件下载
......