### 针对步骤2,需要考虑的业务造成数据变动的情况有
1. 文本和语音数据存在多语种问题,而图片数据形式单一
2. 文本和语音数据存在版本变动情况,章节内的对应图片也可能发生变化,必须能够允许更新
[疑问,更新的最小单位是整本侧记还是侧记的某个章节]
3. 扩充内容,待定
* * * * *
# 接口设计规范
### 数据传输协议 **HTTP**
### 接口定义
| 接口类型 | 接口定义 | 示例 |
| --- | --- | --- | --- |
| 音频接口 | /media/<md5> | /media/41de8466f5eb7c5as52a8a0c0b226da6 |
| 图片接口 | /media/<md5> | /images/52a8a0c0b226da651de8466f5eb7c5a5 |
| 文本接口 | 下方定义 | 待定 |
| 待定 | 待定 | 待定 |
* 获取书籍列表
GET /book?lang=
注:可以分为 /all ,/en /ch
~~~
{
"result":"success",
"errCode":0,
"list":[
{
"id":223,
"name":"师傅侧记",
"language":"CH",
"version":1.12,
"tag":"",
"cover":"", //封面
"desc":"学诚大和尚的生平事迹",
"extra":{
"kaishi":[{
"title":"",
"image":"",
"url":""
}]
}
]
}
~~~
* 获取书籍内容
GET /book/223
~~~
{
"result":"success",
"errCode":0,
"book":{
"id":223,
"name":"师傅侧记",
"language":"CH",
"version":1.12,
"tag":"",
"desc":"学诚大和尚的生平事迹",
"cover":"" //封面
},
"content":[{
"text":"", // 正文
"aduioUrl":"", // 音频链接
"audioTimeFrame":"", // 音频对应时间
"imageUrl",["", ""], // 图片链接
"type":"", // 标题,序言,正文
"index":"1-3" ,
"position":1 ,// 段落位置
"annotation":[
{
"code":"",
"target":"", // 被解释词汇
"explain":"" //解释
} ]
}]
}
~~~