huayandong / recommend-api

纸质作业接口文档

• 日期：20181228
• APP：学生端
• 版本：学生端X.X.0版（发布会版本）

1. 首页一级页面接口

• URL: {{localhost}}/boxfish-wudaokou-paper/paper/ai/getPaperSummary?access_token={{token}}
• Method: POST
• Request:

参数	类型	说明
gradeList	数组	学生年级：如果不区分上下学期，则传入上下两个学期的年级

• Response:

参数	类型	说明
typeDesc	string	培优课类型描述
courseTypeV3	String
amountCourse	数字	已完成培优课数量
amountFresh	数字	未查看数量
courseName	String	课程名称
courseCover	String	课程封面， MD5
finishedRate	String	完成率

{
    "emptyType": "GRADE_NO_COURSE",
    "sectionList": [
        {
            "typeDesc": "智能单词课",
            "courseTypeV3": "WORD",
            "amountCourse": 4,
            "amountFresh": 2,
            "courseName": "智能单词课四下1-Lesson1",
            "finishedRate": "25"
        },
        {
            "typeDesc": "智能知识点课",
            "courseTypeV3": "KNOWLEDGE",
            "amountCourse": 5,
            "amountFresh": 1,
            "courseName": "人大附朝分M11U1",
            "courseCover": "9462a20102520cfcaa46b5219f841a62",
            "finishedRate": "20"
        },
        {
            "typeDesc": "智能阅读课",
            "courseTypeV3": "READING",
            "amountCourse": 4,
            "amountFresh": 1,
            "courseName": "北京二中八上M01自测",
            "courseCover": "9462a20102520cfcaa46b5219f841a62",
            "finishedRate": "25"
        }
    ]
}

2. 智能培优课课程列表页面，二姐列表页面

• URL: {{localhost}}/boxfish-wudaokou-paper/paper/ai/getPaperList?access_token={{token}}
• Method: POST
• Request:

参数	类型	说明
courseTypeV3	String	进入培优课类型：WORD："智能单词课"，KNOWLEDGE："智能知识点课"，READING："智能阅读课"
gradeList	数组	学生年级：如果不区分上下学期，则传入上下两个学期的年级

• Response:

参数	类型	说明
typeDesc	String
courseTypeV3	String
paperList	数组	课程信息

3. 点击进入二级页面，上报取消红点显示接口

• URL: {{localhost}}/boxfish-wudaokou-paper/paper/ai/subjective/recoverFreshFlag?access_token={{token}}
• Method: POST
• Request:

参数	类型	说明
courseTypeV3	String	进入培优课类型：WORD："智能单词课"，KNOWLEDGE："智能知识点课"，READING："智能阅读课"
gradeList	数组	学生年级：如果不区分上下学期，则传入上下两个学期的年级

• Response: 成功：200状态码

4. 扫描二维码，获取自主学习课程信息

• URL: {{localhost}}/boxfish-wudaokou-paper/paper/ai/getQrCourseInfo?access_token={{token}}&qrCode={{qrCode}}
• Method: GET
• Request: qrCode: 二维码code
• Response:

参数	类型	说明
flagQrCourseAuth	boolean	是否有本课的权限：false表示没有，null表示有权限
courseCode	String	二维码code
courseTypeV3	String	培优课类型:
grade	String
gradeIndex	数字	年级
courseId	String
courseProjectName	String
courseTag	课程信息	自主学习课程信息
paperId	String
paperName	String