[关闭]
@chengxuyuan 2020-01-02T06:53:52.000000Z 字数 25099 阅读 616

课程管理、班级管理、学生管理文档

学管系统

获取直播课程等级列表

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
GET /server/live_course/list_courseLevel/ 直播课程等级列表 NO

Response

  1. {
  2.   "count": 1,
  3.   "next": null,
  4.   "previous": null,
  5.   "results": [
  6.     {
  7.       "pk": 2,
  8.       "name": "编程思维初级",
  9.       "desciption": ""
  10.     }
  11.   ]
  12. }

获取直播课分类列表

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
GET /server/live_course/list_LiveCourseCategory/ 直播课分类列表 YES

Response

  1. {
  2.   "count": 9,
  3.   "next": null,
  4.   "previous": null,
  5.   "results": [
  6.     {
  7.       "pk": 9,
  8.       "name": "活动课",
  9.       "desciption": "活动课"
  10.     },
  11.     {
  12.       "pk": 8,
  13.       "name": "NOIP",
  14.       "desciption": "NOIP"
  15.     },
  16.     {
  17.       "pk": 7,
  18.       "name": "IGCSE",
  19.       "desciption": "IGCSE"
  20.     },
  21.     {
  22.       "pk": 6,
  23.       "name": "试听体验课",
  24.       "desciption": "试听体验课"
  25.     },
  26.     {
  27.       "pk": 5,
  28.       "name": "公开课",
  29.       "desciption": "公开课"
  30.     },
  31.     {
  32.       "pk": 4,
  33.       "name": "开发思维",
  34.       "desciption": "开发思维"
  35.     },
  36.     {
  37.       "pk": 3,
  38.       "name": "计算思维",
  39.       "desciption": "计算思维"
  40.     },
  41.     {
  42.       "pk": 2,
  43.       "name": "编程创作",
  44.       "desciption": "编程创作"
  45.     },
  46.     {
  47.       "pk": 1,
  48.       "name": "编程思维",
  49.       "desciption": "编程思维"
  50.     }
  51.   ]
  52. }

课程管理

创建直播课分类下直播课程

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
POST /server/job_management/create_live_course/ 创建直播课分类下直播课程 YES

Request Parameters

Name Description Required Default
course_name 课程名称 YES
course_code 课程代号 YES
course_category 直播课分类的 pk YES
age_range 年龄适用范围 NO
class_time 上课时间 YES
time_limit 上课期限 YES
teacher 老师的名字 NO
teacher_Avatar 老师的头像 NO
class_teacher 班主任的名字 NO
class_teacher_avatar 班主任的头像 NO
class_number 总课时数 NO
amount 金额 NO
sales_commission 代理商销售佣金 NO
entire_commission 是否全额佣金 NO False
apple_product_id 苹果产品 id NO
apple_product_amount 苹果产品价格 NO
cover_url 封面 NO
grey_cover_url 未购买封面 NO
weekly_class_time 每周上课时间 NO
banner 大图 NO
isend 课程是否结束购买 NO False
description_urls 课程介绍图片地址 NO
description_mobile_urls 课程介绍图片地址--手机端 NO
show_in_wx 是否显示在服务号 NO True

Request Data

  1. {
  2.     "course_name":"test",
  3.     "course_code":"001",
  4.     "course_category":2,
  5.     "age_range":"6-8岁",
  6.     "class_time":"2019-04-14 17:30:00",
  7.     "time_limit":"2019-04-14 17:30:00",
  8.     "teacher":"陈微",
  9.     "teacher_Avatar":"https://static1.bcjiaoyu.com/5a7ede147308f194ed9b108f98589a07_v.jpg-1080x1920",
  10.     "class_teacher":"陈微",
  11.     "class_teacher_avatar":"https://static1.bcjiaoyu.com/5a7ede147308f194ed9b108f98589a07_v.jpg-1080x1920",
  12.     "class_number":20,
  13.     "amount":7999,
  14.     "sales_commission":20,
  15.     "entire_commission":false,
  16.     "apple_product_id":"",
  17.     "apple_product_amount":999,
  18.     "cover_url":"https://124.jpg",
  19.     "grey_cover_url":"https://124.jpg",
  20.     "weekly_class_time":"每周三晚上 7：30",
  21.     "banner":"https://124.jpg",
  22.     "isend":false,
  23.     "description_urls":"",
  24.     "description_mobile_urls":"",
  25.     "show_in_wx":true
  26. }

Response

  1. {
  2.       "pk": 16,
  3.       "course_name": "test002",
  4.       "course_code": "test003",
  5.       "course_category": 1,
  6.       "category_display": "编程思维",
  7.       "class_time": "2019-03-28 18:39",
  8.       "time_limit": "2019-04-30 18:39",
  9.       "teacher": null,
  10.       "teacher_Avatar": null,
  11.       "class_teacher": null,
  12.       "amount": "3999.00",
  13.       "add_time": "2019-03-28 18:40",
  14.       "class_teacher_avatar": null,
  15.       "class_number": 0,   //这个是总课时数
  16.       "apple_product_id": "APP_PRODUCT_TEST_001",
  17.       "apple_product_amount": "0.00",
  18.       "current_time": "2019-05-23 16:52:22.552264",
  19.       "cover_url": "http://www.example.com",
  20.       "grey_cover_url": "http://www.example.com",
  21.       "weekly_class_time": null,
  22.       "banner": "http://www.example.com",
  23.       "age_range": "10",
  24.       "sales_commission": "0.00",
  25.       "descriptions": [
  26.         ""
  27.       ],
  28.       "show_in_wx": false,
  29.       "mobile_descriptions": [
  30.         ""
  31.       ],
  32.       "number": 1,
  33.       "less_class_number": 1,   //这个是剩余课时数
  34. }

获取直播课分类下所有直播课程

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
GET /server/job_management/list_live_course/ 直播课分类下所有直播课程列表 YES

category：当不传 categroy 时，默认取所有直播课程。示例: /server/job_management/list_live_course/?category=1

Response

  1. {
  2.   "count": 3,
  3.   "next": null,
  4.   "previous": null,
  5.   "results": [
  6.     {
  7.       "pk": 16,
  8.       "course_name": "test002",
  9.       "course_code": "test003",
  10.       "class_time": "2019-03-28T18:39:00",
  11.       "teacher": null,
  12.       "class_teacher": null,
  13.       "number": 3
  14.     },
  15.     {
  16.       "pk": 10,
  17.       "course_name": "编程思维第二期",
  18.       "course_code": null,
  19.       "class_time": "2019-01-17T11:58:00",
  20.       "teacher": "刘彧彤",
  21.       "class_teacher": "李晓旋",
  22.       "number": 2
  23.     },
  24.     {
  25.       "pk": 2,
  26.       "course_name": "编程思维",
  27.       "course_code": null,
  28.       "class_time": "2019-02-13T19:00:00",
  29.       "teacher": "刘乐乐老师",
  30.       "class_teacher": "马瑞",
  31.       "number": 76
  32.     }
  33.   ]
  34. }

学生管理

某班级的所有用户、已购买某直播课程用户列表

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
GET /server/job_management/list_users/ 获取某个班级下的所有用户信息 YES

按条件过滤列表释义如下 :
team(班级pk)：示例:/server/job_management/list_users/?team=9 某个班级的用户列表
live_course(直播课程pk)：示例:/server/job_management/list_users/?live_course=9 购买了某个课程的直播课订单用户列表
is_buy_live(是否买了直播课程)：示例:/server/job_management/list_users/?is_buy_live=True 购买过直播课的用户列表

按照学生账号、姓名搜索列表释义如下:
search 示例:/server/job_management/list_users/?search=15201052252 或 /server/job_management/list_users/?search=勿问情殇

Response

  1. {
  2.   "count": 2,
  3.   "next": null,
  4.   "previous": null,
  5.   "results": [
  6.     {
  7.       "pk": 8902,
  8.       "owner": "15600116619",
  9.       "name": "15600116619",
  10.       "age": 0,
  11.       "sex": "N",
  12.       "sex_display": "未知",
  13.       "province": null,
  14.       "city": null,
  15.       "address": {
  16.         "shipping_address": "",
  17.         "linkman": ""
  18.       },
  19.       "team": {
  20.         "pk": 9,
  21.         "live_course": 41,
  22.         "name": "研发小班",
  23.         "members": "15201052252,15600116619",
  24.         "class_teacher": "马瑞"
  25.       }
  26.     },
  27.     {
  28.       "pk": 365,
  29.       "owner": "15201052252",
  30.       "name": "啦啦啦",
  31.       "age": 0,
  32.       "sex": null,
  33.       "sex_display": null,
  34.       "province": null,
  35.       "city": "",
  36.       "address": {
  37.         "shipping_address": "",
  38.         "linkman": ""
  39.       },
  40.       "team": {
  41.         "pk": 9,
  42.         "live_course": 41,
  43.         "name": "研发小班",
  44.         "members": "15201052252,15600116619",
  45.         "class_teacher": "马瑞"
  46.       }
  47.     }
  48.   ]
  49. }

已购买某直播课程用户列表

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
GET /server/job_management/list_live_course_purchase_users/ 已购买某直播课程用户列表 YES

live_course(直播课程pk)：示例: /server/job_management/list_live_course_purchase_users/?live_course=10

Response

  1. {
  2.   "count": 2,
  3.   "next": null,
  4.   "previous": null,
  5.   "results": [
  6.     {
  7.       "pk": 8870,
  8.       "owner": "18516271364",
  9.       "name": "小橙子_tsk1cl",
  10.       "age": 0,
  11.       "sex": "N",
  12.       "sex_display": "未知",
  13.       "province": null,
  14.       "city": null,
  15.       "address": {
  16.         "shipping_address": "",
  17.         "linkman": ""
  18.       },
  19.       "team": null
  20.     },
  21.     {
  22.       "pk": 8131,
  23.       "owner": "15010710528",
  24.       "name": "廖海娟",
  25.       "age": 0,
  26.       "sex": "N",
  27.       "sex_display": "未知",
  28.       "province": null,
  29.       "city": null,
  30.       "address": {
  31.         "pk": 598,
  32.         "shipping_address": "北京-丰台区--日月天地大厦B座",
  33.         "linkman": "小绿君"
  34.       },
  35.       "team": null
  36.     }
  37.   ]
  38. }

批量修改用户信息

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
PUT /server/job_management/batch_update_users/ 批量修改用户信息 YES

Request Parameters

Name Description Required Default
add_scholarship 新增奖学金 NO
add_orange_gold 新增橙意金 NO
add_diamond 新增蓝钻 NO
add_red_diamond 新增红钻 NO
add_transfer_time 新增转介绍课时 NO
usernames 用户的账号组 YES

Request Data

  1. {
  2.     "usernames":[15201052252, 15010710528],
  3.     "add_scholarship":2,
  4.     "add_orange_gold":2,
  5.     "add_diamond":2,
  6.     "add_red_diamond":2,
  7.     "add_transfer_time":2
  8. }

Response

  1. {
  2.   "status": 0,
  3.   "message": ""
  4. }

修改用户信息

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
PUT /server/job_management/update_users/${username}/ 修改用户信息 YES

Request Parameters

Name Description Required Default
name 姓名 NO
age 年龄 NO
sex 性别 NO
province 省份 NO
city 城市 NO
address_data 收货地址 NO
add_scholarship 新增奖学金 NO
add_orange_gold 新增橙意金 NO
add_diamond 新增蓝钻 NO
add_red_diamond 新增红钻 NO
add_transfer_time 新增转介绍课时 NO
basis 基础 NO
remark 备注 NO

sex: F(女)、M(男)、N(未知)
shipping_address：收货地址
linkman：收件人

Request Data

  1. {
  2.     "name":"勿问情殇",
  3.     "add_scholarship":50,
  4.     "add_orange_gold":50,
  5.     "add_diamond":50,
  6.     "add_red_diamond":50,
  7.     "add_transfer_time":50,
  8.     "age":"25",
  9.     "sex":"F",
  10.     "province":"河南省",
  11.     "city": "北京",
  12.     "address_data": {
  13.         "shipping_address": "北京市朝阳区高家园2区",
  14.         "linkman": "陈微"
  15.     },
  16.     "basis":"fds",
  17.     "remark":"fsfd"
  18. }

Response

  1. {
  2.   "pk": 365,
  3.   "owner": "15201052252",
  4.   "name": "勿问情殇",
  5.   "age": 25,
  6.   "diamond": 5841,
  7.   "red_diamond": 25050,
  8.   "scholarship": 2,
  9.   "orange_gold": 2,
  10.   "transfer_time": 2,
  11.   "sex": "F",
  12.   "sex_display": "女",
  13.   "province": "河南省",
  14.   "city": "北京",
  15.   "address": {
  16.     "pk": 609,
  17.     "shipping_address": "北京市朝阳区高家园2区",
  18.     "linkman": "陈微"
  19.   },
  20.   "team": null,
  21.   "basis":"fds",
  22.   "remark":"fsfd"
  23. }

解锁用户游戏

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
PUT /server/job_management/unlock_users/${username}/ 解锁用户游戏 YES

Response

  1. {
  2.   "pk": 365,
  3.   "owner": "15201052252",
  4.   "name": "勿问情殇",
  5.   "age": 27,
  6.   "diamond": 5841,
  7.   "red_diamond": 25050,
  8.   "scholarship": 2,
  9.   "orange_gold": 2,
  10.   "sex": "F",
  11.   "sex_display": "女",
  12.   "province": "河南省",
  13.   "city": "北京",
  14.   "address": {
  15.     "pk": 609,
  16.     "shipping_address": "北京市朝阳区高家园2区",
  17.     "linkman": "陈微"
  18.   },
  19.   "team": null,
  20.   "game_unlock": true
  21. }

班级管理

新建班级

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
POST /server/job_management/create_team/ 新建班级 YES

Request Parameters

Name Description Required Default
name 班级名称 YES
members 班级成员账号组，逗号分开的字符串 YES
live_course 是否到课 YES

Request Data

  1. {
  2.     "name":"研发小班2",
  3.     "members":"18839123617,15201052252",
  4.     "live_course":"2"
  5. }

Response

  1. {
  2.   "pk": 2,
  3.   "live_course": 2,
  4.   "course_data": {
  5.     "course_code": null,
  6.     "course_name": "编程思维"
  7.   },
  8.   "name": "研发小班02",
  9.   "members": "18839123617,15201052252",
  10.   "class_teacher": "马瑞"
  11. }

修改班级

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
PUT /server/job_management/update_team/${pk}/ 修改班级 YES

pk：班级的 pk

Request Parameters

Name Description Required Default
name 班级名称 YES
add_members 新增成员账号组 YES
remove_members 移除成员账号组 YES

Request Data

  1. {
  2.     "name":"研发小班02",
  3.     "add_members":"15201052252,15010710528",
  4.     "remove_members":"15010710528,15001051230"
  5. }

Response

  1. {
  2.   "pk": 2,
  3.   "live_course": 2,
  4.   "course_data": {
  5.     "course_code": null,
  6.     "course_name": "编程思维"
  7.   },
  8.   "name": "研发小班02",
  9.   "members": "18839123617,15201052252",
  10.   "class_teacher": "马瑞"
  11. }

分类下班级列表、直播课程下班级列表

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
GET /server/job_management/list_team/ 班级列表 YES

category(直播课分类 pk)：当不传 categroy 时，默认取所有班级。示例: /server/job_management/list_team/?category=1
live_course(直播课程 pk): 示例 /server/job_management/list_team/?live_course=10

Response

  1. {
  2.   "count": 1,
  3.   "next": null,
  4.   "previous": null,
  5.   "results": [
  6.     {
  7.       "pk": 9,
  8.       "live_course": 2,
  9.       "name": "研发小班",
  10.       "members": "15201052252,15600116619",
  11.       "class_teacher": "马瑞"
  12.     }
  13.   ]
  14. }

直播课学情表

新建学情表

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
POST /server/job_management/create_live_academic/ 新建学情表 YES

Request Parameters

Name Description Required Default
owner 用户的账号 YES
team 班级pk YES
classroom 教室 pk YES
is_classroom 是否到课 YES
not_reason 未到原因 YES
is_leave 是否请假 YES
is_look 是否已看回放(未到) YES
is_submit 直播项目是否提交 YES
right_num 答对数 YES
answer_num 答题数 YES
total_num 题目总数 YES
classroom_activity 课堂活跃度 YES
project_completion 项目完成度 YES
project_innovation 项目创新度 YES
remark 备注 YES

classroom_activity:(1-5)之间的数字
project_completion:(1-5)之间的数字
project_innovation:(1-5)之间的数字

Request Data

  1. {
  2.     "owner":"15201052252",
  3.     "team":9,
  4.     "classroom":2,
  5.     "is_classroom":false,
  6.     "not_reason":"",
  7.     "is_leave":false,
  8.     "is_look":false,
  9.     "is_submit":false,
  10.     "right_num":5,
  11.     "answer_num":8,
  12.     "total_num":10,
  13.     "classroom_activity":5,
  14.     "project_completion":5,
  15.     "project_innovation":5,
  16.     "remark":""
  17. }

Response

  1. {
  2.     "pk": 6,
  3.     "owner": "15010710528",
  4.     "name": "廖海娟",
  5.     "team": "研发小班1",
  6.     "live_classroom": "编程思维测试_001",
  7.     "is_classroom": false,
  8.     "not_reason": "",
  9.     "is_leave": false,
  10.     "is_look": false,
  11.     "is_submit": false,
  12.     "right_num": 5,
  13.     "answer_num": 8,
  14.     "total_num": 10,
  15.     "classroom_activity": 5,
  16.     "project_completion": 5,
  17.     "project_innovation": 5,
  18.     "remark": "",
  19.     "answer_rate": "80%",
  20.     "right_rate": "62%"
  21. }

修改用户学情表

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
PUT /server/job_management/update_live_academic/${pk}/ 修改用户学情表 YES

pk：学情表的 pk

Request Parameters

Name Description Required Default
is_classroom 是否到课 YES
not_reason 未到原因 YES
is_leave 是否请假 YES
is_look 是否已看回放(未到) YES
is_submit 直播项目是否提交 YES
right_num 答对数 YES
answer_num 答题数 YES
total_num 题目总数 YES
classroom_activity 课堂活跃度 YES
project_completion 项目完成度 YES
project_innovation 项目创新度 YES
remark 备注 YES

classroom_activity:(1-5)之间的数字
project_completion:(1-5)之间的数字
project_innovation:(1-5)之间的数字

Request Data

  1. {
  2.     "is_classroom":false,
  3.     "not_reason":"",
  4.     "is_leave":false,
  5.     "is_look":false,
  6.     "is_submit":false,
  7.     "right_num":5,
  8.     "answer_num":8,
  9.     "total_num":10,
  10.     "classroom_activity":5,
  11.     "project_completion":5,
  12.     "project_innovation":5,
  13.     "remark":""
  14. }

Response

  1. {
  2.   "pk": 3,
  3.   "owner": "15201052252",
  4.   "name": "廖海娟",
  5.   "team": "研发小班1",
  6.   "live_classroom": "编程思维测试_001",
  7.   "is_classroom": false,
  8.   "not_reason": "回复哈哈哈服",
  9.   "is_leave": false,
  10.   "is_look": false,
  11.   "is_submit": false,
  12.   "right_num": 5,
  13.   "answer_num": 8,
  14.   "total_num": 10,
  15.   "classroom_activity": 5,
  16.   "project_completion": 5,
  17.   "project_innovation": 5,
  18.   "remark": "分解机撒可富",
  19.   "answer_rate": "80%",
  20.   "right_rate": "62%"
  21. }

批量修改用户学情表

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
PUT /server/job_management/batch_update_live_academic/ 批量修改用户学情表 YES

Request Parameters

Name Description Required Default
is_classroom 是否到课 YES
not_reason 未到原因 YES
is_leave 是否请假 YES
is_look 是否已看回放(未到) YES
is_submit 直播项目是否提交 YES
right_num 答对数 YES
answer_num 答题数 YES
total_num 题目总数 YES
classroom_activity 课堂活跃度 YES
project_completion 项目完成度 YES
project_innovation 项目创新度 YES
knowledge_use 知识运用 YES
answer_speed 答题速度 YES
frustration_ability 抗挫折能力 YES
remark 备注 YES

classroom_activity:(1-5)之间的数字
project_completion:(1-5)之间的数字
project_innovation:(1-5)之间的数字
knowledge_use:(1-5)之间的数字
answer_speed:(1-5)之间的数字
frustration_ability:(1-5)之间的数字

Request Data

  1. {
  2.     "record_data": [{
  3.         "pk": 665,
  4.         "is_classroom": false,
  5.         "not_reason": "回复哈哈哈服",
  6.         "is_leave": false,
  7.         "is_look": false,
  8.         "is_submit": false,
  9.         "right_num": 5,
  10.         "answer_num": 8,
  11.         "total_num": 10,
  12.         "classroom_activity": 5,
  13.         "project_completion": 5,
  14.         "project_innovation": 5,
  15.         "remark": "分解机撒可富"
  16.     },
  17.     {
  18.         "pk": 664,
  19.         "is_classroom": false,
  20.         "not_reason": "回复哈哈哈服",
  21.         "is_leave": false,
  22.         "is_look": false,
  23.         "is_submit": false,
  24.         "right_num": 5,
  25.         "answer_num": 8,
  26.         "total_num": 10,
  27.         "classroom_activity": 5,
  28.         "project_completion": 5,
  29.         "project_innovation": 5,
  30.         "remark": "分解机撒可富"
  31.     }]
  32. }

Response

  1. [
  2.   {
  3.     "pk": 665,
  4.     "owner": "15201052252",
  5.     "name": "勿问情殇",
  6.     "team": "先导课3",
  7.     "live_classroom": "先导课2",
  8.     "is_classroom": false,
  9.     "not_reason": "回复哈哈哈服",
  10.     "is_leave": false,
  11.     "is_look": false,
  12.     "is_submit": false,
  13.     "right_num": 5,
  14.     "answer_num": 8,
  15.     "total_num": 10,
  16.     "classroom_activity": 5,
  17.     "project_completion": 5,
  18.     "project_innovation": 5,
  19.     "knowledge_use": 0,
  20.     "answer_speed": 0,
  21.     "frustration_ability": 0,
  22.     "remark": "分解机撒可富",
  23.     "answer_rate": "80%",
  24.     "right_rate": "62%"
  25.   },
  26.   {
  27.     "pk": 664,
  28.     "owner": "15201052252",
  29.     "name": "勿问情殇",
  30.     "team": "先导课3",
  31.     "live_classroom": "先导课3",
  32.     "is_classroom": false,
  33.     "not_reason": "回复哈哈哈服",
  34.     "is_leave": false,
  35.     "is_look": false,
  36.     "is_submit": false,
  37.     "right_num": 5,
  38.     "answer_num": 8,
  39.     "total_num": 10,
  40.     "classroom_activity": 5,
  41.     "project_completion": 5,
  42.     "project_innovation": 5,
  43.     "knowledge_use": 0,
  44.     "answer_speed": 0,
  45.     "frustration_ability": 0,
  46.     "remark": "分解机撒可富",
  47.     "answer_rate": "80%",
  48.     "right_rate": "62%"
  49.   }
  50. ]

获取某个班级学情表、直播教室的学情表、所有的学情表

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
GET /server/job_management/list_live_academic/ 获取某个班级的学情表、某个直播教室的学情表、所有的学情表 YES

按条件过滤列表释义如下 :
live_classroom(直播教室pk)：示例: /server/job_management/list_live_academic/?live_classroom=41
team(班级 pk):示例：/server/job_management/list_live_academic/?team=9
owner(用户 username):示例：/server/job_management/list_live_academic/?owner=15201052252
category(直播课程分类 pk):示例：/server/job_management/list_live_academic/?category=13
live_course(直播课程 pk):示例：/server/job_management/list_live_academic/?live_course=9
上述参数可自由组合

按用户账号和名字搜索列表释义如下:
search 示例: /server/job_management/list_live_academic/?search=15201052252

Response

  1. {
  2.   "count": 1,
  3.   "next": null,
  4.   "previous": null,
  5.   "results": [
  6.     {
  7.       "pk": 6,
  8.       "owner": "15010710528",
  9.       "name": "廖海娟",
  10.       "team": "研发小班1",
  11.       "live_classroom": "编程思维测试_001",
  12.       "is_classroom": false,
  13.       "not_reason": "",
  14.       "is_leave": false,
  15.       "is_look": false,
  16.       "is_submit": false,
  17.       "right_num": 5,
  18.       "answer_num": 8,
  19.       "total_num": 10,
  20.       "classroom_activity": 5,
  21.       "project_completion": 5,
  22.       "project_innovation": 5,
  23.       "remark": "",
  24.       "answer_rate": "80%",
  25.       "right_rate": "62%"
  26.     }
  27.   ]
  28. }

修改某个直播教室已到学生的到课情况

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
PUT /server/job_management/calculation_arrived_rate/ 修改某个直播教室已到学生的到课情况 YES

Request Parameters

Name Description Required Default
pk 直播教室的 pk YES
arrived_user 已到学生账号组 YES

Request Data

  1. {
  2.     "pk":167,
  3.     "arrived_user":["15201052252"]
  4. }

Response

  1. {
  2.   "status": 0,
  3.   "message": ""
  4. }

练习课学情表

新建学情表

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
POST /server/job_management/create_exercise_academic/ 新建直播课学情表 YES

Request Parameters

Name Description Required Default
owner 用户的账号 YES
team 班级pk YES
classroom 教室 pk YES
is_submit_ontime 是否准时提交 YES
is_explain 是否提前说明(未提交) YES
is_submit_later 是否补交 YES
is_correction 是否订正 YES
right_num 答对数 YES
total_num 题目总数 YES
content 家长沟通情况 YES
wrong_point 错点 YES

Request Data

  1. {
  2.     "owner":"15201052252",
  3.     "team":9,
  4.     "classroom":9,
  5.     "is_submit_ontime":false,
  6.     "is_explain":false,
  7.     "is_submit_later":false,
  8.     "is_correction":false,
  9.     "right_num":5,
  10.     "total_num":10,
  11.     "content":"",
  12.     "wrong_point":""
  13. }

Response

  1. {
  2.   "pk": 1,
  3.   "owner": "15201052252",
  4.   "name": "勿问情殇",
  5.   "team": "研发小班",
  6.   "live_classroom": "编程思维测试_001",
  7.   "is_submit_ontime": false,
  8.   "is_explain": false,
  9.   "is_submit_later": false,
  10.   "is_correction": false,
  11.   "right_num": 5,
  12.   "total_num": 10,
  13.   "content": "",
  14.   "wrong_point": "",
  15.   "right_rate": "50%"
  16. }

修改用户学情表

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
PUT /server/job_management/update_exercise_academic/${pk}/ 修改用户学情表 YES

pk：学情表的 pk

Request Parameters

Name Description Required Default
is_submit_ontime 是否准时提交 YES
is_explain 是否提前说明(未提交) YES
is_submit_later 是否补交 YES
is_correction 是否订正 YES
right_num 答对数 YES
total_num 题目总数 YES
content 家长沟通情况 YES
wrong_point 错点 YES

Request Data

  1. {
  2.     "is_submit_ontime":false,
  3.     "is_explain":false,
  4.     "is_submit_later":false,
  5.     "is_correction":false,
  6.     "right_num":5,
  7.     "total_num":10,
  8.     "content":"哈哈哈",
  9.     "wrong_point":"哈哈哈"
  10. }

Response

  1. {
  2.   "pk": 1,
  3.   "owner": "15201052252",
  4.   "name": "勿问情殇",
  5.   "team": "研发小班",
  6.   "live_classroom": "编程思维测试_001",
  7.   "is_submit_ontime": false,
  8.   "is_explain": false,
  9.   "is_submit_later": false,
  10.   "is_correction": false,
  11.   "right_num": 5,
  12.   "total_num": 10,
  13.   "content": "哈哈哈",
  14.   "wrong_point": "哈哈哈",
  15.   "right_rate": "50%"
  16. }

批量修改用户学情表

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
PUT /server/job_management/batch_update_exercise_academic/ 批量修改用户学情表 YES

Request Parameters

Name Description Required Default
is_submit_ontime 是否准时提交 YES
is_explain 是否提前说明(未提交) YES
is_submit_later 是否补交 YES
is_correction 是否订正 YES
right_num 答对数 YES
total_num 题目总数 YES
content 家长沟通情况 YES
wrong_point 错点 YES

Request Data

  1. {
  2.     "record_data":[{
  3.         "pk":23,
  4.         "is_submit_ontime":false,
  5.         "is_explain":false,
  6.         "is_submit_later":false,
  7.         "is_correction":false,
  8.         "right_num":5,
  9.         "total_num":10,
  10.         "content":"哈哈哈",
  11.         "wrong_point":"哈哈哈"
  12.     },
  13.     {
  14.         "pk":21,
  15.         "is_submit_ontime":false,
  16.         "is_explain":false,
  17.         "is_submit_later":false,
  18.         "is_correction":false,
  19.         "right_num":5,
  20.         "total_num":10,
  21.         "content":"哈哈哈",
  22.         "wrong_point":"哈哈哈"
  23.     }]
  24. }

Response

  1. [
  2.   {
  3.     "pk": 23,
  4.     "owner": "15201052252",
  5.     "name": "勿问情殇",
  6.     "team": "研发小班",
  7.     "live_classroom": "编程创作试听课-第一节练习课",
  8.     "is_submit_ontime": false,
  9.     "is_explain": false,
  10.     "is_submit_later": false,
  11.     "is_correction": false,
  12.     "correction_rate": "0%",
  13.     "right_num": 5,
  14.     "total_num": 10,
  15.     "content": "哈哈哈",
  16.     "wrong_point": "哈哈哈",
  17.     "right_rate": "50%"
  18.   },
  19.   {
  20.     "pk": 21,
  21.     "owner": "15010710528",
  22.     "name": "廖海娟",
  23.     "team": "研发小班2",
  24.     "live_classroom": "练习课 第1节",
  25.     "is_submit_ontime": false,
  26.     "is_explain": false,
  27.     "is_submit_later": false,
  28.     "is_correction": false,
  29.     "correction_rate": "0%",
  30.     "right_num": 5,
  31.     "total_num": 10,
  32.     "content": "哈哈哈",
  33.     "wrong_point": "哈哈哈",
  34.     "right_rate": "50%"
  35.   }
  36. ]

获取某个班级学情表、直播教室的学情表、所有的学情表

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
GET /server/job_management/list_exercise_academic/ 获取某个班级的学情表、某个直播教室的学情表、所有的学情表 YES

按条件过滤列表释义如下 :
live_classroom(直播教室pk)：示例: /server/job_management/list_exercise_academic/?live_classroom=41
team(班级 pk):示例：/server/job_management/list_exercise_academic/?team=9
owner(用户 username):示例：/server/job_management/list_exercise_academic/?owner=15201052252
category(直播课程分类 pk):示例：/server/job_management/list_exercise_academic/?category=13
live_course(直播课程 pk):示例：/server/job_management/list_exercise_academic/?live_course=9
上述参数可自由组合

按用户账号和名字搜索列表释义如下:
search 示例: /server/job_management/list_exercise_academic/?search=15201052252

Response

  1. {
  2.   "count": 1,
  3.   "next": null,
  4.   "previous": null,
  5.   "results": [
  6.     {
  7.       "pk": 1,
  8.       "owner": "15201052252",
  9.       "name": "勿问情殇",
  10.       "team": "研发小班",
  11.       "live_classroom": "编程思维测试_001",
  12.       "is_submit_ontime": false,
  13.       "is_explain": false,
  14.       "is_submit_later": false,
  15.       "is_correction": false,
  16.       "right_num": 5,
  17.       "total_num": 10,
  18.       "content": "哈哈哈",
  19.       "wrong_point": "哈哈哈",
  20.       "right_rate": "50%"
  21.     }
  22.   ]
  23. }

班级直播课学情表统计

获取某个班级学情表统计、直播教室的学情表统计、所有的学情表统计

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
GET /server/job_management/list_live_statistics/ 学情表统计列表 YES

live_classroom(直播教室pk)：示例: /server/job_management/list_live_statistics/?live_classroom=41
team(班级 pk):示例：/server/job_management/list_live_statistics/?team=9
两个参数可自由组合

Response

  1. {
  2.   "count": 2,
  3.   "next": null,
  4.   "previous": null,
  5.   "results": [
  6.     {
  7.       "pk": 102,
  8.       "team": {
  9.         "pk": 12,
  10.         "name": "先导课3"
  11.       },
  12.       "live_classroom": {
  13.         "pk": 138,
  14.         "title": "先导课2"
  15.       },
  16.       "narrow_rate": "0.00",
  17.       "general_rate": "0.00",
  18.       "submit_rate": "0.00"
  19.     },
  20.     {
  21.       "pk": 101,
  22.       "team": {
  23.         "pk": 12,
  24.         "name": "先导课3"
  25.       },
  26.       "live_classroom": {
  27.         "pk": 139,
  28.         "title": "先导课3"
  29.       },
  30.       "narrow_rate": "0.00",
  31.       "general_rate": "0.00",
  32.       "submit_rate": "0.00"
  33.     }
  34.   ]
  35. }

班级练习课学情表统计

获取某个班级学情表统计、直播教室的学情表统计、所有的学情表统计

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
GET /server/job_management/list_exercise_statistics/ 学情表统计列表 YES

live_classroom(直播教室pk)：示例: /server/job_management/list_exercise_statistics/?live_classroom=41
team(班级 pk):示例：/server/job_management/list_exercise_statistics/?team=9
两个参数可自由组合

Response

  1. {
  2.   "count": 2,
  3.   "next": null,
  4.   "previous": null,
  5.   "results": [
  6.     {
  7.       "pk": 2,
  8.       "team": {
  9.         "pk": 9,
  10.         "name": "研发小班2"
  11.       },
  12.       "live_classroom": {
  13.         "pk": 38,
  14.         "title": "练习课 第1节"
  15.       },
  16.       "narrow_rate": "0.00",
  17.       "general_rate": "0.00",
  18.       "correction_rate": "0.00"
  19.     },
  20.     {
  21.       "pk": 1,
  22.       "team": {
  23.         "pk": 10,
  24.         "name": "研发小班"
  25.       },
  26.       "live_classroom": {
  27.         "pk": 38,
  28.         "title": "练习课 第1节"
  29.       },
  30.       "narrow_rate": "0.00",
  31.       "general_rate": "0.00",
  32.       "correction_rate": "0.00"
  33.     }
  34.   ]
  35. }

某个学生在某个班的综合学习情况

某个用户在某个班的综合学习情况

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
PUT /server/job_management/student_academic_of_team/ 在班级里以往课程的综合表现 YES

Request Parameters

Name Description Required Default
team 班级的 pk YES
owner 某个用户的账号 YES

Request Data

  1. {
  2.     "team":13,
  3.     "owner":"15010710528"
  4. }

Response

  1. {
  2.   "live_academic_data": {
  3.     "knowledge_use_rate": 0,
  4.     "frustration_ability_rate": 0,
  5.     "classroom_rate": 0,
  6.     "answer_speed_rate": 0,
  7.     "live_answer_rate": 0.8,
  8.     "project_innovation_rate": 1,
  9.     "project_submit_rate":0,
  10.     "live_right_rate": 0.625,
  11.     "classroom_activity_rate": 0.2
  12.   },
  13.   "exercise_academic_data": {
  14.     "exercise_right_rate": 0,
  15.     "correction_rate": 0,
  16.     "submit_ontime_rate": 0
  17.   },
  18.   "team_data": {
  19.     "project_submit_rate": 0.5,
  20.     "exercise_right_rate": 0,
  21.     "live_right_rate": 0.3125
  22.   }
  23. }

某个用户在某个班的所学的直播课学习情况

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
PUT /server/job_management/student_live_academic_of_team/ 某个学生在某个班的每节直播课的答题情况 YES

Request Parameters

Name Description Required Default
team 班级的 pk YES
owner 某个用户的账号 YES

Request Data

  1. {
  2.     "team":13,
  3.     "owner":"15010710528"
  4. }

Response

  1. [
  2.   {
  3.     "pk": 667,
  4.     "owner": "15010710528",
  5.     "name": "廖海娟",
  6.     "team": "先导课3",
  7.     "live_classroom": "先导课2",
  8.     "is_classroom": false,
  9.     "not_reason": "回复哈哈哈服",
  10.     "is_leave": false,
  11.     "is_look": true,
  12.     "is_submit": true,
  13.     "right_num": 5,
  14.     "answer_num": 8,
  15.     "total_num": 10,
  16.     "classroom_activity": 1,
  17.     "project_completion": 1,
  18.     "project_innovation": 5,
  19.     "knowledge_use": 0,
  20.     "answer_speed": 0,
  21.     "frustration_ability": 0,
  22.     "remark": "分解机撒可富",
  23.     "answer_rate": "80%",
  24.     "right_rate": "62%"
  25.   }
  26. ]

某个学生在某个班的每节练习课的答题情况

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
PUT /server/job_management/student_exercise_academic_of_team/ 某个学生在某个班的每节练习课的答题情况 YES

Request Parameters

Name Description Required Default
team 班级的 pk YES
owner 某个用户的账号 YES

Request Data

  1. {
  2.     "team":13,
  3.     "owner":"15010710528"
  4. }

Response

  1. [
  2.     {
  3.       "pk": 21,
  4.       "owner": "15010710528",
  5.       "name": "廖海娟",
  6.       "team": "研发小班2",
  7.       "live_classroom": "练习课 第1节",
  8.       "is_submit_ontime": false,
  9.       "is_explain": false,
  10.       "is_submit_later": false,
  11.       "is_correction": false,
  12.       "right_num": 0,
  13.       "total_num": 0,
  14.       "content": "",
  15.       "wrong_point": "",
  16.       "right_rate": 0
  17.     }
  18. ]

直播教室出题或答题

直播教室出题

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
POST /server/job_management/create_live_question/ 出题 YES

Request Parameters

Name Description Required Default
live_classroom 直播教室的 pk YES
numbering 该题在该教室的唯一编号 YES
answer 该题的正确答案 YES
content 该题详情(一个 json 字符串) YES
question_type 直播课习题类型 YES live

question_type: live 和 practice

Request Data

  1. {
  2.     "live_classroom":139,
  3.     "numbering":"001",
  4.     "answer":"A",
  5.     "content":"{\"type\": \"question\",\"correct\": \"A\",\"options\": \"2\", \"title\": \"啊啊啊啊啊\"}",
  6.     "question_type":"live"
  7. }

Response

  1. {
  2.   "pk": 4,
  3.   "numbering": "003",
  4.   "content": "{\"type\": \"question\",\"correct\": \"A\",\"options\": \"2\", \"title\": \"啊啊啊啊啊\"}",
  5.   "answer": "A",
  6.   "create_time": "2019-05-06T16:28:29.146969",
  7.   "answer_records": [],
  8.   "team": null,
  9.   "live_classroom": 139,
  10.   "question_type":"live
  11. }

某个直播教室所有的答题情况、某道题的情况

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
GET /server/job_management/list_live_question/ 教室所有答题情况 YES

live_classroom(直播教室pk)：示例: /server/job_management/list_live_question/?live_classroom=139
numbering(习题的编号):示例：/server/job_management/list_live_question/?live_classroom=139&numbering=001
team(班级的 pk):示例：/server/job_management/list_live_question/?team=1, 该字段可与上述 api 自由组合

Response

  1. {
  2.   "count": 1,
  3.   "next": null,
  4.   "previous": null,
  5.   "results": [
  6.     {
  7.       "pk": 2,
  8.       "numbering": "001",
  9.       "answer": "A",
  10.       "content":"{\"type\": \"question\",\"correct\": \"A\",\"options\": \"2\", \"title\": \"啊啊啊啊啊\"}"
  11.       "create_time": "2019-04-28T16:13:17.334376",
  12.       "answer_records": [
  13.         {
  14.           "pk": 1,
  15.           "owner": {
  16.             "name": "勿问情殇",
  17.             "avatar": "https://static1.bcjiaoyu.com/5a7ede147308f194ed9b108f98589a07_v.jpg-1080x1920",
  18.             "user": "15201052252",
  19.             "nickname": "chen"
  20.           },
  21.           "live_question": 2,
  22.           "answer": "B",
  23.           "create_time": "2019-04-28T16:39:49.327665",
  24.           "is_right": false,
  25.           "consume_time": 59
  26.         }
  27.       ],
  28.       "team": {
  29.         "total_number":5, 
  30.         "answer_number":4, 
  31.         "right_number":2
  32.       },
  33.       "live_classroom": 139
  34.     }
  35.   ]
  36. }

直播教室答题

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
POST /server/job_management/create_live_answer/ 答题 YES

Request Parameters

Name Description Required Default
live_classroom 直播教室的 pk YES
numbering 该题在该教室的唯一编号 YES
answer 用户选择的答案 YES
question_type 直播课习题类型 YES live

question_type: live 和 practice

Request Data

  1. {
  2.     "numbering":"001",
  3.     "live_classroom":139,
  4.     "answer":"B",
  5.     "question_type":"live"
  6. }

Response

  1. {
  2.   "pk": 1,
  3.   "owner": {
  4.     "name": "勿问情殇",
  5.     "avatar": "https://static1.bcjiaoyu.com/5a7ede147308f194ed9b108f98589a07_v.jpg-1080x1920",
  6.     "user": "15201052252",
  7.     "nickname": "chen"
  8.   },
  9.   "live_question": 2,
  10.   "answer": "B",
  11.   "create_time": "2019-04-28T16:39:49.327665",
  12.   "is_right": false,
  13.   "consume_time": 59
  14. }

获取某个教室的所有答题记录/某个学生的答题记录

Method and URL Structure

Method Method Resource URL Descriptions Authentications Required
GET /server/job_management/list_live_answer/ 答题记录 YES

live_classroom(直播教室pk)：示例: /server/job_management/list_live_answer/?live_classroom=139
owner(学生账号):示例：/server/job_management/list_live_answer/?owner=15201052252

Response

  1. {
  2.   "count": 2,
  3.   "next": null,
  4.   "previous": null,
  5.   "results": [
  6.     {
  7.       "pk": 3,
  8.       "owner": {
  9.         "name": "勿问情殇",
  10.         "avatar": "https://static1.bcjiaoyu.com/5a7ede147308f194ed9b108f98589a07_v.jpg-1080x1920",
  11.         "user": "15201052252",
  12.         "nickname": "chen"
  13.       },
  14.       "live_question": 3,
  15.       "answer": "B",
  16.       "create_time": "2019-05-06T15:59:33.752846",
  17.       "is_right": false,
  18.       "consume_time": 59
  19.     }
  20.   ]
  21. }
添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注