13.4.0.md 3.83 KB

996.icu

v13.4.0接口

1. 【APP接口,新接口】智能练听说模块课程进课权限接口
  • URL: {{localhost}}/boxfish-online-card/member/info/checkSpeakingCourseAuth?access_token={{token}}
  • Method: POST
  • RequestBody:
{
  "courseId": "app_courseId",
  "classType":"TEXTBOOK_V1_SPEAKING"
}

classType为课程类型:TEXTBOOK_V1_SPEAKING为 "教材同步 听说测验",TEXTBOOK_V1_READING为 "教材同步 课文阅读"。

  • ResponseBody:
// 没有权限上课
{
  "status": "ERROR",
  "message": "您暂未获得本课的学习权限,购买学校同步课就可以听说读写一次学完~"
}
// 有权限上课
{
  "status": "SUCCESS",
  "message": "权限校验成功"
}
1.1 教材同步单词课/知识点课 和 四会单词课,进课权限校验接口,之前就存在的接口
  1. 书架教材同步单词课/知识点课 进课权限校验接口:

    {{localhost}}/boxfish-online-card/member/info/checkBasicCourseInfo?access_token={{access_token}}

  2. 四会单词课 进课权限校验接口

    {{localhost}}/boxfish-wudaokou-paper/paper/textbook/getTextbookCourseAuth?access_token={{token}}

2. 【APP接口,旧接口】进阶单词课,二级页面宣传视频资源
  • URL: {{localhost}}/boxfish-wudaokou-user/ticket/BOXFISH_RESOURCE_VIDEO?access_token={{token}}
  • Method: POST
  • ResponseBody:
{
    // 进阶单词课宣传视频 和 视频封面
    "paper_v1_word_introduce_video": "https://assets.boxfish.cn/v/video_word4.mp4",
    "paper_v1_word_introduce_video_cover_pad": "https://avatars.boxfish.cn/app_resources/textbook_v2_word_ipad.png",
    "paper_v1_word_introduce_video_cover_phone": "https://avatars.boxfish.cn/app_resources/textbook_v2_word_iphone.png"
}
3. 【APP接口,旧接口】四会单词课,如果没有开放,新版本APP则不显示当前模块
  • URL: {{localhost}}/boxfish-wudaokou-paper/paper/textbook/getTextbookSummary?access_token=BRE2k5BHnu
  • Method: POST
  • ResponseBody:
{
    "userId": 100000006030,
    "flagIsPublic": false,
    "flagNoPaperTextbook": false,
    "summaryList": [
        {
            "typeDesc": "同步单词课",
            "type": "PAPER_TEXTBOOK_WORD",
            "amountCourse": 22,
            "courseName": "Words_教科版小学三下M1U1-1",
            "courseCover": "3b2e8e9c6d2d20aee9fb71107c4d8b5d",
            "nationalKnowledge": [
                "go to+地点"
            ]
        }
    ]
}
  1. flagIsPublic = true:当前教材版本的四会课已经开放,flagIsPublic = false:当前教材版本的四会课没有开放,显示假数据;

  2. flagNoPaperTextbook = false:当前教材版本有四会课程,不用显示默认文案,flagNoPaperTextbook = true:当前教材版本没有四会课程,显示默认文案;

    当前四会课程要么显示真实课程,要么显示假课程,不会显示默认文案的情况。所以目前flagNoPaperTextbook会一直为false

4. 【APP接口,新接口】书架是否需要显示free标签
  • URL: {{localhost}}/boxfish-online-card/member/textbook/getTextbookTag?access_token=BRE2k5BHnu
  • Method: GET
  • ResponseBody:
{
  "status": "SUCCESS",

  "flagShowTag": true,    // 书架上是否显示free标签
  "unit1Name": "Unit1"    // 第一单元名称
}
5. 【APP接口,新接口】中小学核心单词课程权限校验接口
  • URL: {{localhost}}/boxfish-online-card/member/info/courseAuthCheck/coreWord?access_token={{token}}
  • Method: POST
  • RequestBody:
{
  "courseId": "app_courseId",
  "classType":"CORE_WORD_V1_PRIMARY"
}

classType为课程类型:CORE_WORD_V1_PRIMARY为 "小学核心单词500",CORE_WORD_V1_MIDDLE为 "中考考纲单词1500"。