mirror of
https://github.com/gedoor/legado.git
synced 2024-07-06 23:47:49 +08:00
Update api.md
This commit is contained in:
parent
49d2381b39
commit
82bef81172
77
api.md
77
api.md
@ -1,6 +1,6 @@
|
|||||||
# 阅读API
|
# 阅读[API](/app/src/main/java/io/legado/app/api/controller)
|
||||||
|
|
||||||
## 对于Web的配置
|
## 对于[Web](/app/src/main/java/io/legado/app/web/)的配置
|
||||||
|
|
||||||
您需要先在设置中启用"Web 服务"。
|
您需要先在设置中启用"Web 服务"。
|
||||||
|
|
||||||
@ -14,7 +14,7 @@
|
|||||||
#### 插入单个书源
|
#### 插入单个书源
|
||||||
|
|
||||||
请求BODY内容为`JSON`字符串,
|
请求BODY内容为`JSON`字符串,
|
||||||
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookSource.kt)
|
格式参考[这个文件](/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
|
||||||
@ -24,7 +24,7 @@ Method = POST
|
|||||||
#### 插入多个书源or订阅源
|
#### 插入多个书源or订阅源
|
||||||
|
|
||||||
请求BODY内容为`JSON`字符串,
|
请求BODY内容为`JSON`字符串,
|
||||||
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookSource.kt),**为数组格式**。
|
格式参考[这个文件](/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
|
||||||
@ -51,7 +51,7 @@ Method = GET
|
|||||||
#### 删除多个书源or订阅源
|
#### 删除多个书源or订阅源
|
||||||
|
|
||||||
请求BODY内容为`JSON`字符串,
|
请求BODY内容为`JSON`字符串,
|
||||||
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookSource.kt),**为数组格式**。
|
格式参考[这个文件](/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
|
||||||
@ -59,10 +59,55 @@ URL = http://127.0.0.1:1234/deleteRssSources
|
|||||||
Method = POST
|
Method = POST
|
||||||
```
|
```
|
||||||
|
|
||||||
|
#### 获取替换规则
|
||||||
|
|
||||||
|
```
|
||||||
|
URL = http://127.0.0.1:1234/getReplaceRules
|
||||||
|
Method = GET
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 替换规则管理
|
||||||
|
|
||||||
|
请求BODY内容为`JSON`字符串,
|
||||||
|
替换规则参考[这个文件](/app/src/main/java/io/legado/app/data/entities/ReplaceRule.kt)。
|
||||||
|
|
||||||
|
##### 删除
|
||||||
|
|
||||||
|
```
|
||||||
|
URL = http://127.0.0.1:1234/deleteReplaceRule
|
||||||
|
Method = POST
|
||||||
|
Body = [ReplaceRule]
|
||||||
|
```
|
||||||
|
##### 插入
|
||||||
|
|
||||||
|
```
|
||||||
|
URL = http://127.0.0.1:1234/saveReplaceRule
|
||||||
|
Method = POST
|
||||||
|
Body = [ReplaceRule]
|
||||||
|
```
|
||||||
|
|
||||||
|
##### 测试
|
||||||
|
|
||||||
|
返回测试文本text替换结果
|
||||||
|
|
||||||
|
```
|
||||||
|
URL = http://127.0.0.1:1234/testReplaceRule
|
||||||
|
Method = POST
|
||||||
|
Body = { rule: [ReplaceRule], text: [String] }
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 搜索在线书籍
|
||||||
|
|
||||||
|
```
|
||||||
|
URL = http://127.0.0.1:1234/searchBooks
|
||||||
|
Method = POST
|
||||||
|
Body = { key: [String] }
|
||||||
|
```
|
||||||
|
|
||||||
#### 插入书籍
|
#### 插入书籍
|
||||||
|
|
||||||
请求BODY内容为`JSON`字符串,
|
请求BODY内容为`JSON`字符串,
|
||||||
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/Book.kt)。
|
格式参考[这个文件](/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
|
||||||
@ -103,17 +148,25 @@ URL = http://127.0.0.1:1234/cover?path=xxxxx
|
|||||||
Method = GET
|
Method = GET
|
||||||
```
|
```
|
||||||
|
|
||||||
|
#### 获取正文图片
|
||||||
|
|
||||||
|
```
|
||||||
|
URL = http://127.0.0.1:1234/image?url=${bookUrl}&path=${picUrl}&width=${width}
|
||||||
|
Method = GET
|
||||||
|
```
|
||||||
|
|
||||||
#### 保存书籍进度
|
#### 保存书籍进度
|
||||||
|
|
||||||
请求BODY内容为`JSON`字符串,
|
请求BODY内容为`JSON`字符串,
|
||||||
格式参考[这个文件](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/data/entities/BookProgress.kt)。
|
格式参考[这个文件](/app/src/main/java/io/legado/app/data/entities/BookProgress.kt)。
|
||||||
|
|
||||||
```
|
```
|
||||||
URL = http://127.0.0.1:1234/saveBookProgress
|
URL = http://127.0.0.1:1234/saveBookProgress
|
||||||
Method = POST
|
Method = POST
|
||||||
```
|
```
|
||||||
|
|
||||||
### Content Provider
|
### [Content Provider](/app/src/main/java/io/legado/app/api/ReaderProvider.kt)
|
||||||
|
|
||||||
|
|
||||||
* 需声明`io.legado.READ_WRITE`权限
|
* 需声明`io.legado.READ_WRITE`权限
|
||||||
* `providerHost`为`包名.readerProvider`, 如`io.legado.app.release.readerProvider`,不同包的地址不同,防止冲突安装失败
|
* `providerHost`为`包名.readerProvider`, 如`io.legado.app.release.readerProvider`,不同包的地址不同,防止冲突安装失败
|
||||||
@ -122,7 +175,7 @@ Method = POST
|
|||||||
#### 插入单个书源or订阅源
|
#### 插入单个书源or订阅源
|
||||||
|
|
||||||
创建`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)
|
格式参考[这个文件](/app/src/main/java/io/legado/app/data/entities/BookSource.kt)
|
||||||
|
|
||||||
```
|
```
|
||||||
URL = content://providerHost/bookSource/insert
|
URL = content://providerHost/bookSource/insert
|
||||||
@ -133,7 +186,7 @@ Method = insert
|
|||||||
#### 插入多个书源or订阅源
|
#### 插入多个书源or订阅源
|
||||||
|
|
||||||
创建`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),**为数组格式**。
|
格式参考[这个文件](/app/src/main/java/io/legado/app/data/entities/BookSource.kt),**为数组格式**。
|
||||||
|
|
||||||
```
|
```
|
||||||
URL = content://providerHost/bookSources/insert
|
URL = content://providerHost/bookSources/insert
|
||||||
@ -166,7 +219,7 @@ Method = query
|
|||||||
#### 删除多个书源or订阅源
|
#### 删除多个书源or订阅源
|
||||||
|
|
||||||
创建`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),**为数组格式**。
|
格式参考[这个文件](/app/src/main/java/io/legado/app/data/entities/BookSource.kt),**为数组格式**。
|
||||||
|
|
||||||
```
|
```
|
||||||
URL = content://providerHost/bookSources/delete
|
URL = content://providerHost/bookSources/delete
|
||||||
@ -177,7 +230,7 @@ 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/Book.kt)。
|
格式参考[这个文件](/app/src/main/java/io/legado/app/data/entities/Book.kt)。
|
||||||
|
|
||||||
```
|
```
|
||||||
URL = content://providerHost/book/insert
|
URL = content://providerHost/book/insert
|
||||||
|
Loading…
Reference in New Issue
Block a user