y分享.md 4.72 KB

Raw Blame History Permalink



分享相关


1. 抽奖分享

api-online.test.boxfish.cn/share/acquire/award?access_token=admin

POST
x-www-form-urlencoded参数：

award_code String 奖品码
image_name String 图片名字
title String 小标题
description String 副标题
返回：

{
  "gold": 173,
  "msg": "success",
  "onlineScore": 217,
  "url": "http://api-online.test.boxfish.cn/share/wechat/acquire/award/1/86995d7a-4916-4e25-9b9e-85bc38a49f21"
}


2. 抽奖页面

api-online.test.boxfish.cn/share/wechat/acquire/award/{user_id}/{display_code}
GET


3. 抽奖分享成功回调

/share/acquire/award/success
POST
说明： 对预存储的积分金币加到用户信息中


4. 通用分享接口

/share/for
POST
x-www-form-urlencoded参数：
share_type String 分享类型
参数约定：分享类型都集成在一个枚举里面，
public enum ShareType {
    ACHIEVEMENT,
    DAILY_ACHIEVEMENT,
    DAILY_GOAL_ACHIEVEMENT,
    DAILY_SCORE_RANK,
    TOTAL_SCORE_RANK,
    OPEN_QUESTION,
    AWARD,
    REWARD_LESSON,   //扫一扫,二维码兑换课程
    ONLINE_LESSON,      //在线上课
    BUY_FOREIGN_LESSON,     //购买外教课
    BUY_CHINESE_LESSON,     //购买中教课
    APPRAISE,                //外教点评
    TODAY_HEADLINE,
    ORAL_REPORT,             //口语测评
    BUY_SMALL_LESSON,
    SMALL_LESSON,
    PUB_LESSON,
    FINISH_STUDY            //完成自主学习任务

}
接口中的方法对应每一种分享类型的处理方式，


4.1  完成今日任务  FINISH_STUDY

{
  "title" : "BOXFiSH学员：学习全辅导，每天都上外教课！",
  "imageName" : "award_logo.png",
  "description" : "我在BOXFiSH学英语＃学的不止是英语，更是全球视角下的独立思考。",
  "award_code":"hahaha",
  "lesson_list" : [ {
    "lesson_name" : "Module 1 Unit1_Words 1",
    "lesson_cover" : "https://api.boxfish.cn/student/publication/data/data/96dc1fd345b6d4eeee82c66c6e3e8ddb",
    "lesson_type" : "TEXTBOOK_WORDS"
  } ]
}


4.2 购买小班课  BUY_SMALL_LESSON

{
  "title" : "BOXFiSH学员：学习全辅导，每天都上外教课！",
  "imageName" : "award_logo.png",
  "description" : "我在BOXFiSH学英语＃学的不止是英语，更是全球视角下的独立思考。"
}


4.3 完成小班课 SMALL_LESSON

{
  "title" : "BOXFiSH学员：学习全辅导，每天都上外教课！",
  "imageName" : "award_logo.png",
  "description" : "我在BOXFiSH学英语＃学的不止是英语，更是全球视角下的独立思考。"
}


4.4 完成公开课 PUB_LESSON

{
  "title" : "BOXFiSH学员：学习全辅导，每天都上外教课！",
  "imageName" : "award_logo.png",
  "description" : "我在BOXFiSH学英语＃学的不止是英语，更是全球视角下的独立思考。"
}


4.5 口语测评分享  ORAL_REPORT

{
    "report": "0.4",
    "lesson_id": "L3NoYXJlL3N2bi_kuIrmtbflj6Por63ogIPor5UxLzUwNC7kuIrmtbfluIIyMDE35Lit6ICD5Y-j6K-t57uD5LmgNC54bHN4",
    "dialogue": "0.2分\/10分",
    "review": "嘿，整体都可以做得更好呢。注意多练习发音、多交流，表达自己的观点也要具体些～一定要加油哦。",
    "title": "我参加了盒子鱼口语考试，超智能！不多说，我继续学习去了。",
    "composition": "0.0分\/5分",
    "intonation": "0.2分\/5分",
    "description": "我在学霸之路上越走越远，你不来比划比划？",
    "image_name": "award_logo.png"
}


4.6 兑换课程分享

{
  "title" : "BOXFiSH学员：学习全辅导，每天都上外教课！",
  "imageName" : "award_logo.png",
  "description" : "我在BOXFiSH学英语＃学的不止是英语，更是全球视角下的独立思考。",
  "view" : "chinese"
}


4.7 在线上课分享

{
  "title" : "BOXFiSH学员：学习全辅导，每天都上外教课！",
  "imageName" : "award_logo.png",
  "description" : "我在BOXFiSH学英语＃学的不止是英语，更是全球视角下的独立思考。",
  "lessonName" : "L3NoYXJlL3N2bi_mna3lt57lj6Por63ogIPor5UxLzExMS4g5p2t5beeMjAxN-S4reiAg-WPo-ivree7g-S5oDIueGxzeA"
}


4.8 购买外教课  BUY_FOREIGN_LESSON

{
  "title" : "BOXFiSH学员：学习全辅导，每天都上外教课！",
  "imageName" : "award_logo.png",
  "description" : "我在BOXFiSH学英语＃学的不止是英语，更是全球视角下的独立思考。"
}


4.9 购买中教课  BUY_CHINESE_LESSON

{
  "title" : "BOXFiSH学员：学习全辅导，每天都上外教课！",
  "imageName" : "award_logo.png",
  "description" : "我在BOXFiSH学英语＃学的不止是英语，更是全球视角下的独立思考。"
}


4.10 外教点评  APPRAISE

{
  "title" : "BOXFiSH学员：学习全辅导，每天都上外教课！",
  "imageName" : "award_logo.png",
  "description" : "我在BOXFiSH学英语＃学的不止是英语，更是全球视角下的独立思考。"
}