huayandong / recommend-api

纸质作业接口文档

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

1. 首页一级页面接口

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

{
    "gradeList":[
        "GRADE_4_B"
    ]
}

• Response:

{
    "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":"READING",
    "gradeList":[
        "GRADE_4_B"
    ]
}

• Response:

{
    "typeDesc": "智能阅读课",
    "courseTypeV3": "READING",
    "paperList": [
        {
            "paperId": "L3NoYXJlL3N2bi_mmbrog73kvZzkuJrljJfkuqzkuozkuK3lhavkuIpNMS0xMi8wMDEuTTEueGxzeA",
            "paperName": "北京二中八上M01自测",
            "paperCover": "9462a20102520cfcaa46b5219f841a62",
            "paperIsFresh": false,
            "paperStatus": "NO_SUBMIT",
            "pageIdTotal": [
                "1",
                "2",
                "3",
                "4"
            ],
            "pageIdFinished": [],
            "pageIdUnFinished": [
                "1",
                "2",
                "3",
                "4"
            ],
            "courseId": "L3NoYXJlL3N2bi9MZXZlbCAzX-WNleivjeeUqOazlTIvMjA1LuWNleivjeeUqOazlV9waG90bywgcGljdHVyZSDnhafniYcueGxzeA",
            "svHasConsume": false,
            "courseGrade": "C",
            "nationalKnowledge": [
                "照片photo/picture"
            ],
            "updateTime": "2018-12-27T05:44:31.000Z"
        },
        {
            "paperId": "L3NoYXJlL3N2bi_mmbrog73kvZzkuJrkurrlpKfpmYTmnJ3pmLPliIbmoKHnm67moIfnu4PkuaBNMTEtMTIvMDA1Lk0xMl9Vbml0IDIgVmllbm5hIGlzIHRoZSBjZW50cmUgb2YgRXVyb3BlYW4gY2xhc3NpY2FsIG11c2ljLi54bHN4",
            "paperName": "人大附朝分M12U2",
            "paperCover": "8218f25eb8fcf27ea78e2c3e7e740cb4",
            "paperIsFresh": true,
            "paperStatus": "SUPERVISING_FINISHED",
            "pageIdTotal": [
                "10",
                "11",
                "9"
            ],
            "pageIdFinished": [
                "10",
                "11",
                "9"
            ],
            "pageIdUnFinished": [],
            "courseId": "L3NoYXJlL3N2bi9MZXZlbCA0X0dyYW1tYXIxLzAwNi7lpoLkvZXooajovr7kuI3noa7lrprnmoTkurrmiJbnianvvJ8ueGxzeA",
            "svHasConsume": true,
            "courseGrade": "A_PLUS",
            "nationalKnowledge": [
                "不定代词someone/anyone/somebody/anybody/something/anything"
            ],
            "updateTime": "2018-12-21T06:24:00.478Z"
        }
    ]
}

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

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

{
    "courseTypeV3":"READING",
    "gradeList":[
        "GRADE_4_B"
    ]
}

• 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	String
paperId	String
paperName	String