liuming / developer-docs

Go to a project
Toggle navigation Toggle navigation pinning
chong
81d4b1b5 1 parent f9866152

Track 8 files into repository. 

- untracked yjw接口文档/y分享.md
- untracked yjw接口文档/y分享统计.md
- untracked yjw接口文档/y口语测评.md
- untracked yjw接口文档/y手机号接口.md
- untracked yjw接口文档/y提交成绩.md
- untracked yjw接口文档/y每日推送.md
- untracked yjw接口文档/y阶段数.md
- modified SUMMARY.md

Auto commit by GitBook Editor
Inline Side-by-side
Showing 8 changed files with 1207 additions and 1 deletions
... ... @@ -255,4 +255,10 @@
* [网络状态检测](未整理/网络状态检测.md)
* [网页测试Demo数据](未整理/网页测试Demo数据.md)
* [获取当前分类下存在的班级](未整理/获取当前分类下存在的班级.md)
* [分享](yjw接口文档/y分享.md)
* [口语测评](yjw接口文档/y口语测评.md)
* [手机号接口](yjw接口文档/y手机号接口.md)
* [提交成绩](yjw接口文档/y提交成绩.md)
* [每日推送](yjw接口文档/y每日推送.md)
* [阶段数](yjw接口文档/y阶段数.md)
* [文案组分享统计](yjw接口文档/y分享统计.md)
... ...
# 分享相关
```
### 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学英语＃学的不止是英语，更是全球视角下的独立思考。"
}
... ...
# 分享统计
```
### 1. 分享成功数量统计
api-online.test.boxfish.cn/count/share?date1=2017-03-29&date2=2017-03-30
GET
x-www-form-urlencoded参数：
date1起始日期
date2末端日期
返回：
{
"title :哪些国家在引领着人工智能的发展？ >>>>分享>>>> 2396 次",
"title :没有朋友的人，和咸鱼有什么区别？ >>>>分享>>>> 1862 次"
}
\ No newline at end of file
... ...
# 口语测评
```
### 1. 口语测评完成度
api-online.test.boxfish.cn/report/group/{group}}/lesson/{lesson}?access_token=admin
GET
访问示例：
api-online.test.boxfish.cn/report/group/9469/lesson/L3NoYXJlL3N2bi9Ub3BpY1_kuKrkurrmg4XlhrUvMDAzLuWmguS9leaIkOS4uuabtOWlveeahOiHquW3se-8ny54bHN4?access_token=admin
返回：
{
"听力测验": [
{
"user_id": 7007,
"user_name": "Huan",
"score": 0
}
],
"type": [
"听力测验"
],
"percentage": "0.17"
}
说明：此接口增加了percentage字段，表示班级中已经完成的人数比率
### 2. 口语测评成绩提交
api-online.test.boxfish.cn/commit/record/batch?access_token=admin
POST
body参数：
{
"cr_list": [{
"credit": 1102,
"fact_score": 1.713699913024902,
"quiz_id": "oo-11",
"score": 5,
"equal": 0.3427399826049805,
"gold": 0,
"quiz_type": "ORAL_INTONATION",
"duration": 46.48099899291992,
"audio_url": "http:\/\/edu.hivoice.cn:80\/WebAudio-1.0-SNAPSHOT\/audio\/play\/D923E81D-5D41-402F-9A9C-C471AD18B461\/1483583474648405519\/gz",
"finished_time": 1483583852,
"channel": "ORAL_TEST"
}, {
"credit": 107,
"fact_score": 0.6627500152587891,
"quiz_id": "oo-21",
"score": 1,
"equal": 0.6627500152587891,
"gold": 0,
"quiz_type": "ORAL_DIALOGUE",
"duration": 15.46100044250488,
"audio_url": "http:\/\/edu.hivoice.cn:80\/WebAudio-1.0-SNAPSHOT\/audio\/play\/80B813C9-E2CC-4CF7-AF3C-540A876AED20\/1483583541114792703\/gz",
"finished_time": 1483583852,
"channel": "ORAL_TEST"
}, {
"credit": 307,
"fact_score": 0.6970199775695801,
"quiz_id": "oo-31",
"score": 6,
"equal": 0.1161699962615967,
"gold": 0,
"quiz_type": "ORAL_COMPOSITION",
"duration": 10.84099960327148,
"audio_url": "http:\/\/edu.hivoice.cn:80\/WebAudio-1.0-SNAPSHOT\/audio\/play\/E2B6BDE1-D890-4EA8-AF4A-7D1A819DDFA8\/1483583830243491916\/gz",
"finished_time": 1483583852,
"channel": "ORAL_TEST"
}],
"user_id": "1",
"lesson_id": "L3NoYXJlL3N2bi_ljJfkuqzlj6Por63ogIPor5UxLzEwMi7ljJfkuqzliJ3kuIDlj6Por63nu4PkuaDpopgyLnhsc3gyjw211"
}
返回参数：
{
"record_score": 70462,
"gold": 4876,
"msg": "success"
}
... ...
# 手机号相关
```
#### 1. 绑定手机号
api-online.test.boxfish.cn/mobile/send?access_token=admin&mobile=17051100900
POST
返回参数：
{
"success": true
}
异常参数：
throw ['手机格式不正确']
throw ['该手机号已经被绑定，请确认是否绑定过其他帐号哟～']
throw ['验证码发送过频,请稍后再试']
#### 2. 检验验证码
api-online.test.boxfish.cn/mobile/check?access_token=admin&mobile=17051100900&code=2128
GET/POST
返回参数：
{
"status": "valid"
}
#### 3. 更改手机号
api-online.test.boxfish.cn/user/mobile?access_token=admin&mobile=17051100900&code=3257
POST
返回参数：
{
"success": true
}
异常参数：
throw ['手机格式不正确']
throw ['手机号码已被绑定']
throw ['验证码不正确']
#### 4. 删除此用户手机绑定
api-online.test.boxfish.cn/user/mobile?access_token=admin&mobile=17051100900&code=3257
DELETE
返回参数：无
#### 5. 删除此手机号绑定
api-online.test.boxfish.cn/user/mobile/{mobileId}}?access_token=admin
示例：
api-online.test.boxfish.cn/user/mobile/17051100900?access_token=admin
返回参数：无
... ...
# 提交成绩
```
### 1. 公开课成绩提交限制次数
api-online.test.boxfish.cn/statistic/user/score/{userId}}?access_token=admin
POST
示例：api-online.test.boxfish.cn/statistic/user/score/1?access_token=admin
返回参数：
{
"theScore": 300,
"sumScore": 36636.40017700195
}
### 2. 自主学习提交成绩
api-online.test.boxfish.cn/event/statistic/article/progress?access_token=UC77eM0pZ7
POST
body参数：
{
"goal": {
"toefl": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"primary": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"seniorHigh": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"total": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"juniorHigh": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
]
},
"record": [
{
"lesson": "L3NoYXJlL3N2bi9MZXZlbCAyX0Z1bmN0aW9uMS8wMDEu5aaC5L2V6KGo6L6-4oCc5pep5LiK5aW94oCd77yfLnhsc3g",
"score": 14,
"userId": 1299909,
"equal": 1,
"count": 3,
"original": "in the morning",
"duration": 1.686477,
"transcription": "In the morning.",
"createTime": 1490757225568
},
{
"lesson": "L3NoYXJlL3N2bi9MZXZlbCAyX0Z1bmN0aW9uMS8wMDEu5aaC5L2V6KGo6L6-4oCc5pep5LiK5aW94oCd77yfLnhsc3g",
"score": 0,
"userId": 1299909,
"equal": 0,
"count": 0,
"original": "in the afternoon",
"duration": 3.917294,
"transcription": "",
"createTime": 1490757241313
},
{
"lesson": "L3NoYXJlL3N2bi9MZXZlbCAyX0Z1bmN0aW9uMS8wMDEu5aaC5L2V6KGo6L6-4oCc5pep5LiK5aW94oCd77yfLnhsc3g",
"score": 0,
"userId": 1299909,
"equal": 0,
"count": 0,
"original": "in the afternoon",
"duration": 1.167468,
"transcription": "",
"createTime": 1490757247501
},
{
"lesson": "L3NoYXJlL3N2bi9MZXZlbCAyX0Z1bmN0aW9uMS8wMDEu5aaC5L2V6KGo6L6-4oCc5pep5LiK5aW94oCd77yfLnhsc3g",
"score": 28,
"userId": 1299909,
"equal": 0.833333,
"count": 3,
"original": "Good morning, Kate!",
"duration": 2.93153,
"transcription": "Good morning kids.",
"createTime": 1490757257610
},
{
"lesson": "L3NoYXJlL3N2bi9MZXZlbCAyX0Z1bmN0aW9uMS8wMDEu5aaC5L2V6KGo6L6-4oCc5pep5LiK5aW94oCd77yfLnhsc3g",
"score": 24,
"userId": 1299909,
"equal": 1,
"count": 2,
"original": "Good morning!",
"duration": 2.175412,
"transcription": "Good morning.",
"createTime": 1490757267263
},
{
"lesson": "L3NoYXJlL3N2bi9MZXZlbCAyX0Z1bmN0aW9uMS8wMDEu5aaC5L2V6KGo6L6-4oCc5pep5LiK5aW94oCd77yfLnhsc3g",
"score": 0,
"userId": 1299909,
"equal": 0,
"count": 0,
"original": "Good afternoon, afternoon, afternoon.",
"duration": 0.585477,
"transcription": "",
"createTime": 1490757281740
}
],
"read": [
{
"wordCount": 3,
"count": 1,
"userId": 1299909,
"level": 1,
"md5": "C9351E2E6FF6E9982DDB6E31D5426B9A"
},
{
"wordCount": 2,
"count": 1,
"userId": 1299909,
"level": 1,
"md5": "D56BF970B2BD8C25AB544C337531C117"
}
],
"multiwordList": [
{
"count": 2,
"multiword": "the,the,other,UD"
},
{
"count": 2,
"multiword": "in,in,prep,UD"
},
{
"count": 4,
"multiword": "morning,morning,n,NN"
},
{
"count": 5,
"multiword": "afternoon,afternoon,n,NN"
},
{
"count": 6,
"multiword": "good,good,adj,JJ"
},
{
"count": 1,
"multiword": "kate,kate,n,NN"
},
{
"count": 1,
"multiword": "and,and,conj,UD"
},
{
"count": 1,
"multiword": "now,now,adv,RB"
},
{
"count": 1,
"multiword": "mom,mom,n,NN"
},
{
"count": 1,
"multiword": "you,you,pron,UD"
},
{
"count": 1,
"multiword": "dad,dad,n,NN"
},
{
"count": 1,
"multiword": "or,or,conj,UD"
},
{
"count": 1,
"multiword": "right,right,adv,RB"
},
{
"count": 1,
"multiword": "say,say,v,VB"
},
{
"count": 1,
"multiword": "to,to,other,UD"
},
{
"count": 1,
"multiword": "your,you,pron,UD"
},
{
"count": 1,
"multiword": "should,should,v,UD"
},
{
"count": 1,
"multiword": "evening,evening,n,NN"
},
{
"count": 1,
"multiword": "what,what,pron,UD"
}
],
"newWord": "19",
"userId": 1299909,
"words": [
{
"template": 1,
"summary": {
"other": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"primary": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"seniorHigh": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"juniorHigh": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"toefl": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
]
}
},
{
"template": 3,
"summary": {
"other": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"primary": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"seniorHigh": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"juniorHigh": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"toefl": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
]
}
},
{
"template": 6,
"summary": {
"other": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"primary": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"seniorHigh": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"juniorHigh": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"toefl": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
]
}
},
{
"template": 500,
"summary": {
"other": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"primary": [
2,
2,
0,
0,
0,
0,
0,
0,
0,
0
],
"seniorHigh": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"juniorHigh": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"toefl": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
]
}
},
{
"template": 501,
"summary": {
"other": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"primary": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"seniorHigh": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"juniorHigh": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"toefl": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
]
}
},
{
"template": 502,
"summary": {
"other": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"primary": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"seniorHigh": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"juniorHigh": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"toefl": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
]
}
},
{
"template": 503,
"summary": {
"other": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"primary": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"seniorHigh": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"juniorHigh": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"toefl": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
]
}
}
],
"wordCount": 19,
"listening": [],
"lessonId": "L3NoYXJlL3N2bi9MZXZlbCAyX0Z1bmN0aW9uMS8wMDEu5aaC5L2V6KGo6L6-4oCc5pep5LiK5aW94oCd77yfLnhsc3g",
"phrase": {
"phraseListeningDuration": 36.97965532879818,
"phraseListening": [
{
"learningCount": 1,
"listeningCount": 1
},
{
"learningCount": 1,
"listeningCount": 1
}
],
"phraseLearning": [
2,
0,
0,
0,
0,
0,
0,
0,
0,
0
]
},
"cr_list": [
{
"credit": 18,
"fact_score": 16.73800086975098,
"quiz_id": "RHBAZSH001",
"score": 100,
"equal": 0.1674000024795532,
"gold": 9,
"quiz_type": "ORAL_QUESTION",
"duration": 3.801000118255615,
"audio_url": "http://edu.hivoice.cn:80/WebAudio-1.0-SNAPSHOT/audio/play/76738EAB-4CA5-432C-B581-C50C7B0FF123/1490757289661660814/bj",
"finished_time": 1490757344,
"channel": "IN_QUESTION"
}
]
}
返回参数：
{
"score": 55335,
"theScore": 88,
"learning": {
"wordCount": 19,
"readWordCount": 5,
"recordScore": 84,
"listeningDuration": 36,
"multiwordNum": 0,
"progressTodayStart": "1.756",
"progressTodayNow": "1.756",
"todayScore": 88
},
"stageLevelOld": 2,
"stageOld": 1,
"stageLevelNow": 2,
"stageNow": 1,
"progressOld": "1.756",
"progressNow": "1.756"
}
### 3. 在线上课提交成绩
api-online.test.boxfish.cn/event/statistic/online/progress?access_token=admin
POST
x-www-form-urlencoded参数：
lesson_id=L3NoYXJlL3N2bi_kurrmlZnlhavlubTnuqfkuIsgVW5pdDYvMDAyLTEu5ZCM5q2l5ZCs5Yqb77yaQW4gb2xkIG1hbiB0cmllZCB0byBtb3ZlIHRoZSBtb3VudGFpbnMuIDEueGxzeA
message=message
level=4
class_type=SMALL
参数约定：
```
//1v1中教课
ONLINE_CHINESE,
//1v1外交课
ONLINE_FOREIGN,
//小班课外教4人
SMALL_FOREIGN_4
```
返回：
{
"stageLevelOld": 1,
"stageOld": 1,
"stageLevelNow": 1,
"stageNow": 1,
"currentProgress": "1.719",
"userMultiwordCount": 219,
"recordScore": 68946,
"theScore": 978,
"sumScore": 374016.00000429153
}
... ...
# 每日推送
```
### 1. 文案组生成页面工具接口
api-online.test.boxfish.cn/share/wechat/inner/recommendation 不需要token
POST
BODY参数：
{
"title": "一条大河实在是真特么宽哈",
"description": "alskdjfalks00\n00asldfkaja",
"picUrl": "http://assets.boxfish.cn/images/award/box_open.png",
"videoUrl": "http://assets.boxfish.cn/v/%E6%9E%97%E4%B9%A6%E82%B1%AA%E6%95%99%E5%AD1%A6v4.mp4",
"uploadAt": "2017/03/29",
"recLevel": "3"
}
### 2. 客户端获取今日推送视频接口
访问例子:
api-online.test.boxfish.cn/recommendation/today?access_token=admin&preference_level=7
访问方式：GET
访问参数：
preference_level int类型 即：用户偏好设置
返回例子：
{
"upload_at": "2017-03-28",
"title": "test33",
"video_url": "http://assets.boxfish.cn/daily-video/test.mp4",
"description": "test33",
"url": "http://api-online.test.boxfish.cn/share/wechat/access/38da3a2a26b53822b24b6bdca95e92de",
"pic_url": "http://assets.boxfish.cn/daily-video/video-cover/test.jpg"
}
### 3. 观看视频增加听力时长
api-online.test.boxfish.cn/finish/recommendation?access_token=admin&listening_time=8
POST
参数：listening_time 听力时长，单位秒，Long型
返回：
{
"msg": "success"
}
... ...
# 阶段数
```
### 1. 首页查询阶段数信息
api-online.test.boxfish.cn/event/statistic/stage/info?access_token=admin
GET
返回：
{
"stage_level": 1,
"stage": 1,
"progress": "0.00",
"record_score": 0,
"listening_duration": 8,
"multiword_count": 0
}
### 2. 阶段数对学习量预测接口
api-online.test.boxfish.cn/stage/multiword/info?access_token=admin
GET
返回：
{
"increment": {
"multi_word_increase": 748,
"word_increase": 706,
"reading_amount_increase": 569,
"listening_time_increase": 8238,
"record_time_increase": 9968,
"phrase_increase": 501
},
"weeks": "预计1周完成",
"level": 1,
"stage": 1
}
### 3. 首页学习情况显示总量接口
api-online.test.boxfish.cn/event/statistic/learning/today/progress?access_token=admin
GET
返回：
{
"wordCount": 0,
"readWordCount": 0,
"recordScore": 0,
"listeningDuration": 8,
"multiwordNum": 0,
"progressTodayStart": "1.719",
"progressTodayNow": "1.719",
"todayScore": 0,
"stageLevel": 1,
"stage": 1
}
### 4. 设置学习偏好
api-online.test.boxfish.cn/preference/setting?access_token=admin
POST
x-www-form-urlencoded参数：
grade="六年级"
publication=“PEP版六年级上”
level=1
plan=ONE_HOUR
备注：plan约定（HALF_HOUR , ONE_HOUR , TWO_HOUR）
返回：
{
"goal": {
"id": 1,
"current_step": 3218,
"goal_step": 55000
}
}
### 5. 设置课程学习计划
api-online.test.boxfish.cn/preference/purchase/setting?purchase=OPEN_4P&access_token=admin
POST
参数约定：
purchase=OPEN或OPEN_4P或OPEN_1P;
返回:
{
"msg": "success"
}
... ...