### 針對步驟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":"" //解釋
} ]
}]
}
~~~