职位选择

[校招VIP]“推推P2”1添加书籍和定时任务模块JAVA接口文档

10月09日 JAVA接口文档说明 添加书籍&定时任务模块 推推P2
视频说明
点击观看
学生周最佳
暂时没有
最后修订
2024-10-09

接口分类

接口名

说明

用户新增小说查询

loadLatestNovels

拉取用户提交的待新增的最新size个书名


updateStatus

将新增小说状态变成已处理

小说主表

loadNovelByName

通过名称查询对应书籍(本接口本模块忽略)


insert

添加小说(本接口本模块忽略)

添加小说

verifyNovelRules

解析和验证正版和盗版规则,成功后返回规则


AddNovelRules

添加小说


一、 loadLatestNovels 

1 接口说明

新增小说查询接口:拉取用户提交的待新增的未处理的最新10个书名

2 接口请求参数说明

http 请求方式:POST(实习同学调用测试接口,需要跟运营申请iToken)

https://api1.naoffer.com/newNovel/loadLatestNovels

参数

是否必须

举例

说明





3 接口返回参数说明

参数

是否必须

举例

说明

novelNameList


10个小说的名称


4 返回示例【开发结束后补充】

(1)成功返回

{
"success":true,
"msg":"success",
"data": [{"id":1,"name":"天道图书馆"},{"id":2,"name":"天道图书馆1"},{"id":3,"name":"天道图书馆2"},。。。]
}

(2)失败返回(无)


二、updateStatus

1 接口说明

将新增小说状态变成已处理

2 接口请求参数说明

http 请求方式:POST(实习同学调用测试接口,需要跟运营申请iToken)

https://api1.naoffer.com/newNovel/updateStatus

参数

是否必须

举例

说明

id

1

新增查询小说表 id

3 接口返回参数说明

参数

是否必须

举例

说明

data



4 返回示例【开发结束后补充】

(1)成功返回

{
"success":true,
"msg":"success",
"data": null
}

(2)失败返回

{
"success":false,
"msg":"请求参数不正确",
"data":null
}



三、verifyNovelRules

1 接口说明

解析和验证正版和盗版规则,成功后返回规则

2 接口请求参数说明

http 请求方式:POST(实习同学调用测试接口,需要跟运营申请iToken)

https://api1.naoffer.com/novelRules/verifyNovelRules

参数

是否必须

举例

说明

officialUrl


官方章节列表url

officialPlatform


1 pc 2 m

officialOrder


1 正序 2 倒序

searchUrl

0

非官方章节列表url

searchPlatform

0

1 pc 2 m

searchOrder

0

1 正序 2 倒序





3 接口返回参数说明

参数

是否必须

举例

说明

officialChapters


官方最新两个章节名称

searchChapter



非官方最新1个章节

officialRule



官方解析规则,失败为“”

searchRule



非官方解析规则,失败为“”

4 返回示例【开发结束后补充】

(1)成功返回

{"success":true,"msg":"success","data":{}}

(2)失败返回

{"success":false,"msg":"解析失败","data":null}


四、AddNovelRules(本次不做更新)

1 接口说明

添加小说和小说规则,小说主表的添加可以适当缩减,在本模块不重要

为做重点,本模块也不做已存在小说的规则更新,即查询小说名称存在的话,就不处理

2 接口请求参数说明

http 请求方式:POST(实习同学调用测试接口,需要跟运营申请iToken)

https://api1.naoffer.com/novelRules/AddNovelRules


officialRule



解析接口返回的正版

searchRule



解析接口返回的盗版

officialPlatform


1 pc 2 m

officialOrder


1 正序 2 倒序

searchUrl

0

非官方章节列表url

searchPlatform

0

1 pc 2 m

searchOrder

0

1 正序 2 倒序

bookName




authorName



(可以不处理authorId)

cover




bookBrief



小说简介

bookType



小说类型(可以不处理)


3 接口返回参数说明

参数

是否必须

举例

说明

bookId


小说主表id

4 返回示例【开发结束后补充】

(1)成功返回

{"success":true,"msg":"success","data":{"bookId":1000}}

(2)失败返回

{"success":false,"msg":"小说添加失败","data":null}


历史周最佳