Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/howie6879/owllook_api

owllook - 简洁优雅的小说API🎉
https://github.com/howie6879/owllook_api

api gin novel owllook

Last synced: about 1 month ago
JSON representation

owllook - 简洁优雅的小说API🎉

Host: GitHub
URL: https://github.com/howie6879/owllook_api
Owner: howie6879
License: mit
Created: 2018-06-29T10:05:08.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2018-07-03T03:53:11.000Z (over 6 years ago)
Last Synced: 2024-06-20T15:11:01.248Z (6 months ago)
Topics: api, gin, novel, owllook
Language: Go
Homepage:
Size: 13.7 KB
Stars: 132
Watchers: 4
Forks: 45
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

## owllook小说接口

[![GitHub release](https://img.shields.io/github/release/howie6879/owllook_api.svg)](https://github.com/howie6879/owllook_api/releases) [![Github All Releases](https://img.shields.io/github/downloads/howie6879/owllook_api/total.svg)](https://github.com/howie6879/owllook_api/releases) [![license](https://img.shields.io/github/license/howie6879/owllook_api.svg)](https://github.com/howie6879/owllook_api/blob/master/LICENSE)

本项目提供优雅的小说接口，其他衍生项目如下：

- 公众号：[**粮草小说**](http://oe7yjec8x.bkt.clouddn.com/howie/2018-03-13-%E7%B2%AE%E8%8D%89%E5%B0%8F%E8%AF%B4.jpg-blog.howie)，有兴趣的话可以关注下
- 官网：[https://www.owllook.net](https://www.owllook.net)
- 监控工具：[owllook_gui](https://github.com/howie6879/owllook_gui)

### Overview

[owllook](https://github.com/howie6879/owllook)是一个基于其他搜索引擎构建的垂直小说搜索引擎，owllook目的是让阅读更简单、优雅，让每位读者都有舒适的阅读体验，有朋友有兴趣开发owllook的app端，于是此项目便诞生了，本项目提供小说的一系列接口，如检索、目录、章节内容、检查更新

#### Installation

`owllook_api`基于[gin](https://github.com/gin-gonic/gin)，提供了一系列基本的小说接口，使用：

``` shell
git clone https://github.com/howie6879/owllook_api
cd owllook_api

go get -u github.com/kardianos/govendor
govendor sync
go run main.go

# 编译
CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -o ./release/owllook_api.mac
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o ./release/owllook_api.linux
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o ./release/owllook_api.exe
```

#### API

小说资源说明：

本项目利用了互联网上的一些小说资源作为检索目标进行资源提取，定义如下，100以后的命名定位第三方检索：

| 名称 | 编号 |搜索类型 |
| :--- | -------- | ----------- |
| 10 | 笔趣阁 | 站内 |
| 100 | 新笔趣阁 | 百度第三方 |
| 110 | 笔下文学 | 百度第三方 |
| 120 | 顶点小说 | 百度第三方 |

**搜索小说：**

格式：/v1/novels/:name/:source

请求：

``` shell
# 请求资源为10下小说牧神记的检索结果
curl http://0.0.0.0:8080/v1/novels/牧神记/10
```

响应：

``` json
{
"info": [
{
"novel_abstract": "大墟的祖训说，天黑，别出门。大墟残老村的老弱病残们从江边捡到了一个婴儿，取名秦牧，含辛茹苦将他养大。这一天夜幕降临，……",
"novel_author": "作者：宅猪",
"novel_cover": "https://www.bqg99.cc/bookimages/2640967.jpg",
"novel_latest_chapter_name": "第七百九十二章道一（月底求月票）",
"novel_latest_chapter_url": "https://www.bqg99.cc/book/2639610/595030666.html",
"novel_name": "牧神记",
"novel_type": "分类：玄幻",
"novel_url": "https://www.bqg99.cc/book/2639610/",
"source_name": "笔趣阁01",
"source_url": "https://www.bqg99.cc/"
}
],
"status": 1
}
```

**搜索作者：**

格式：/v1/authors/:name/:source

请求：

``` shell
curl http://0.0.0.0:8080/v1/authors/猫腻/10
```

响应：

``` json
{
"info": [
{
"novel_abstract": "千里杀一人，十步不愿行。",
"novel_author": "作者：猫腻",
"novel_cover": "https://www.bqg99.cc/bookimages/1849310.jpg",
"novel_latest_chapter_name": "今天没有更新",
"novel_latest_chapter_url": "https://www.bqg99.cc/book/1847953/594800464.html",
"novel_name": "大道朝天",
"novel_type": "分类：玄幻",
"novel_url": "https://www.bqg99.cc/book/1847953/",
"source_name": "笔趣阁01",
"source_url": "https://www.bqg99.cc/"
},
{
"novel_abstract": "命里有时终须有，命里无时要强求。　　这是一个长生果的故事。……",
"novel_author": "作者：猫腻",
"novel_cover": "https://www.bqg99.cc/bookimages/1008998084.jpg",
"novel_latest_chapter_name": "后记",
"novel_latest_chapter_url": "https://www.bqg99.cc/book/1008996727/644149409.html",
"novel_name": "择天记",
"novel_type": "分类：玄幻",
"novel_url": "https://www.bqg99.cc/book/1008996727/",
"source_name": "笔趣阁01",
"source_url": "https://www.bqg99.cc/"
},
{
"novel_abstract": "与天斗，其乐无穷。　　……",
"novel_author": "作者：猫腻",
"novel_cover": "https://www.bqg99.cc/bookimages/1010262420.jpg",
"novel_latest_chapter_name": "第六卷忽然之间第一百三十章结尾",
"novel_latest_chapter_url": "https://www.bqg99.cc/book/1010261063/959174919.html",
"novel_name": "将夜",
"novel_type": "分类：玄幻",
"novel_url": "https://www.bqg99.cc/book/1010261063/",
"source_name": "笔趣阁01",
"source_url": "https://www.bqg99.cc/"
},
{
"novel_abstract": "世界上有两件东西能够深深地震撼人们的心灵，一件是我们心中崇高的道德准则，另一件是我们头顶上灿烂的星空——康德　　当许……",
"novel_author": "作者：猫腻",
"novel_cover": "https://www.bqg99.cc/bookimages/1011122532.jpg",
"novel_latest_chapter_name": "最后的单章：间客关门八件事",
"novel_latest_chapter_url": "https://www.bqg99.cc/book/1011121175/979602210.html",
"novel_name": "间客",
"novel_type": "分类：玄幻",
"novel_url": "https://www.bqg99.cc/book/1011121175/",
"source_name": "笔趣阁01",
"source_url": "https://www.bqg99.cc/"
},
{
"novel_abstract": "积善之家，必有余庆，留余庆，留余庆，忽遇恩人；幸娘亲，幸娘亲，积得阴功。劝人生，济困扶穷……而谁可知，人生于世，……",
"novel_author": "作者：猫腻",
"novel_cover": "https://www.bqg99.cc/bookimages/1012231120.jpg",
"novel_latest_chapter_name": "第七卷朝天子末章后来",
"novel_latest_chapter_url": "https://www.bqg99.cc/book/1012229763/989671183.html",
"novel_name": "庆余年",
"novel_type": "分类：历史",
"novel_url": "https://www.bqg99.cc/book/1012229763/",
"source_name": "笔趣阁01",
"source_url": "https://www.bqg99.cc/"
}
],
"status": 1
}
```