Skip to content

Latest commit

 

History

History
158 lines (131 loc) · 6.67 KB

README.md

File metadata and controls

158 lines (131 loc) · 6.67 KB

owllook小说接口

GitHub release Github All Releases license

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

Overview

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

Installation

owllook_api基于gin,提供了一系列基本的小说接口,使用:

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

请求:

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

响应:

{
    "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

请求:

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

响应:

{
    "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
}