pull/1894/head^2
kunfei 3 years ago
parent 044dbfd316
commit 42c2d453f0
  1. 98
      api.md

@ -1,30 +1,37 @@
# 阅读API # 阅读API
## 对于Web的配置 ## 对于Web的配置
您需要先在设置中启用"Web 服务"。 您需要先在设置中启用"Web 服务"。
## 使用 ## 使用
### Web ### Web
以下说明假设您的操作在本机进行,且开放端口为1234。 以下说明假设您的操作在本机进行,且开放端口为1234。
如果您要从远程计算机访问[阅读](),请将`127.0.0.1`替换成手机IP。 如果您要从远程计算机访问[阅读](),请将`127.0.0.1`替换成手机IP。
#### 插入单个书源 #### 插入单个书源
请求BODY内容为`JSON`字符串,
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookSource.kt)
``` ```
URL = http://127.0.0.1:1234/saveSource URL = http://127.0.0.1:1234/saveSource
Method = POST Method = POST
``` ```
请求BODY内容为`JSON`字符串,
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookSource.kt)
#### 插入多个书源or订阅源 #### 插入多个书源or订阅源
请求BODY内容为`JSON`字符串,
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookSource.kt),**为数组格式**。
``` ```
URL = http://127.0.0.1:1234/saveBookSources URL = http://127.0.0.1:1234/saveBookSources
URL = http://127.0.0.1:1234/saveRssSources URL = http://127.0.0.1:1234/saveRssSources
Method = POST Method = POST
``` ```
请求BODY内容为`JSON`字符串,
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookSource.kt),**为数组格式**。
#### 获取书源 #### 获取书源
``` ```
@ -43,25 +50,27 @@ Method = GET
#### 删除多个书源or订阅源 #### 删除多个书源or订阅源
请求BODY内容为`JSON`字符串,
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookSource.kt),**为数组格式**。
``` ```
URL = http://127.0.0.1:1234/deleteBookSources URL = http://127.0.0.1:1234/deleteBookSources
URL = http://127.0.0.1:1234/deleteRssSources URL = http://127.0.0.1:1234/deleteRssSources
Method = POST Method = POST
``` ```
#### 插入书籍
请求BODY内容为`JSON`字符串, 请求BODY内容为`JSON`字符串,
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookSource.kt),**为数组格式**。 格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/Book.kt)。
#### 插入书籍
``` ```
URL = http://127.0.0.1:1234/saveBook URL = http://127.0.0.1:1234/saveBook
Method = POST Method = POST
``` ```
请求BODY内容为`JSON`字符串,
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/Book.kt)。
#### 获取所有书籍 #### 获取所有书籍
``` ```
URL = http://127.0.0.1:1234/getBookshelf URL = http://127.0.0.1:1234/getBookshelf
Method = GET Method = GET
@ -70,6 +79,7 @@ Method = GET
获取APP内的所有书籍。 获取APP内的所有书籍。
#### 获取书籍章节列表 #### 获取书籍章节列表
``` ```
URL = http://127.0.0.1:1234/getChapterList?url=xxx URL = http://127.0.0.1:1234/getChapterList?url=xxx
Method = GET Method = GET
@ -78,116 +88,134 @@ Method = GET
获取指定图书的章节列表。 获取指定图书的章节列表。
#### 获取书籍内容 #### 获取书籍内容
``` ```
URL = http://127.0.0.1:1234/getBookContent?url=xxx&index=1 URL = http://127.0.0.1:1234/getBookContent?url=xxx&index=1
Method = GET Method = GET
``` ```
获取指定图书的第`index`章节的文本内容。 获取指定图书的第`index`章节的文本内容。
#### 获取封面 #### 获取封面
``` ```
URL = http://127.0.0.1:1234/cover?path=xxxxx URL = http://127.0.0.1:1234/cover?path=xxxxx
Method = GET Method = GET
``` ```
#### 保存书籍进度
请求BODY内容为`JSON`字符串,
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookProgress.kt)。
```
URL = http://127.0.0.1:1234/saveBookProgress
Method = POST
```
### Content Provider ### Content Provider
* 需声明`io.legado.READ_WRITE`权限 * 需声明`io.legado.READ_WRITE`权限
* `providerHost`为`包名.readerProvider`, 如`io.legado.app.release.readerProvider`,不同包的地址不同,防止冲突安装失败 * `providerHost`为`包名.readerProvider`, 如`io.legado.app.release.readerProvider`,不同包的地址不同,防止冲突安装失败
* 以下出现的`providerHost`请自行替换 * 以下出现的`providerHost`请自行替换
#### 插入单个书源or订阅源 #### 插入单个书源or订阅源
创建`Key="json"`的`ContentValues`,内容为`JSON`字符串,
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookSource.kt)
``` ```
URL = content://providerHost/bookSource/insert URL = content://providerHost/bookSource/insert
URL = content://providerHost/rssSource/insert URL = content://providerHost/rssSource/insert
Method = insert Method = insert
``` ```
创建`Key="json"`的`ContentValues`,内容为`JSON`字符串,
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookSource.kt)
#### 插入多个书源or订阅源 #### 插入多个书源or订阅源
创建`Key="json"`的`ContentValues`,内容为`JSON`字符串,
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookSource.kt),**为数组格式**。
``` ```
URL = content://providerHost/bookSources/insert URL = content://providerHost/bookSources/insert
URL = content://providerHost/rssSources/insert URL = content://providerHost/rssSources/insert
Method = insert Method = insert
``` ```
创建`Key="json"`的`ContentValues`,内容为`JSON`字符串,
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookSource.kt),**为数组格式**。
#### 获取书源or订阅源 #### 获取书源or订阅源
获取指定URL对应的书源信息。
用`Cursor.getString(0)`取出返回结果。
``` ```
URL = content://providerHost/bookSource/query?url=xxx URL = content://providerHost/bookSource/query?url=xxx
URL = content://providerHost/rssSource/query?url=xxx URL = content://providerHost/rssSource/query?url=xxx
Method = query Method = query
``` ```
获取指定URL对应的书源信息。
用`Cursor.getString(0)`取出返回结果。
#### 获取所有书源or订阅源 #### 获取所有书源or订阅源
获取APP内的所有订阅源。
用`Cursor.getString(0)`取出返回结果。
``` ```
URL = content://providerHost/bookSources/query URL = content://providerHost/bookSources/query
URL = content://providerHost/rssSources/query URL = content://providerHost/rssSources/query
Method = query Method = query
``` ```
获取APP内的所有书源。
用`Cursor.getString(0)`取出返回结果。
#### 删除多个书源or订阅源 #### 删除多个书源or订阅源
创建`Key="json"`的`ContentValues`,内容为`JSON`字符串,
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookSource.kt),**为数组格式**。
``` ```
URL = content://providerHost/bookSources/delete URL = content://providerHost/bookSources/delete
URL = content://providerHost/rssSources/delete URL = content://providerHost/rssSources/delete
Method = delete Method = delete
``` ```
#### 插入书籍
创建`Key="json"`的`ContentValues`,内容为`JSON`字符串, 创建`Key="json"`的`ContentValues`,内容为`JSON`字符串,
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookSource.kt),**为数组格式**。 格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/Book.kt)。
#### 插入书籍
``` ```
URL = content://providerHost/book/insert URL = content://providerHost/book/insert
Method = insert Method = insert
``` ```
创建`Key="json"`的`ContentValues`,内容为`JSON`字符串,
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/Book.kt)。
#### 获取所有书籍 #### 获取所有书籍
获取APP内的所有书籍。
用`Cursor.getString(0)`取出返回结果。
``` ```
URL = content://providerHost/books/query URL = content://providerHost/books/query
Method = query Method = query
``` ```
获取APP内的所有书籍。 #### 获取书籍章节列表
获取指定图书的章节列表。
用`Cursor.getString(0)`取出返回结果。 用`Cursor.getString(0)`取出返回结果。
#### 获取书籍章节列表
``` ```
URL = content://providerHost/book/chapter/query?url=xxx URL = content://providerHost/book/chapter/query?url=xxx
Method = query Method = query
``` ```
获取指定图书的章节列表。
用`Cursor.getString(0)`取出返回结果。
#### 获取书籍内容 #### 获取书籍内容
获取指定图书的第`index`章节的文本内容。
用`Cursor.getString(0)`取出返回结果。
``` ```
URL = content://providerHost/book/content/query?url=xxx&index=1 URL = content://providerHost/book/content/query?url=xxx&index=1
Method = query Method = query
``` ```
获取指定图书的第`index`章节的文本内容。
用`Cursor.getString(0)`取出返回结果。
#### 获取封面 #### 获取封面
``` ```
URL = content://providerHost/book/cover/query?path=xxxx URL = content://providerHost/book/cover/query?path=xxxx
Method = query Method = query

Loading…
Cancel
Save