唯读---图书微服务接口设计(持续更新)

科技2022-07-16 144

我们准备先将核心业务部分写出来，先设计出图书微服务的接口，然后实现代码，先写出个后台管理系统。

说明：这个接口设计的不是很完善，后续需要补充的话会慢慢补充上去

BASE_URL：localhost:10010/api/ (zuul网关地址)

1 图书微服务

微服务路由地址

/book/**

1.1 查询所有分类

请求URL

GET /category/list

参数类型:请求体

|参数 |是否必选 |类型 |说明

返回结果

[ { id: 1, typeName: "玄幻"， typeInfo: "这个分类是玄幻", iconUrl:"" }, { id: 2, typeName: "玄幻"， typeInfo: "这个分类是玄幻", iconUrl:"" }, { id: 3, typeName: "玄幻"， typeInfo: "这个分类是玄幻", iconUrl:"" }, { id: 4, typeName: "玄幻"， typeInfo: "这个分类是玄幻", iconUrl:"" }, { id: 5, typeName: "玄幻"， typeInfo: "这个分类是玄幻", iconUrl:"" }, { id: 6, typeName: "玄幻"， typeInfo: "这个分类是玄幻", iconUrl:"" } ]

状态码：

200：查询成功400：参数有误500：服务器内部异常

1.2 根据图书id查询该书的分类

请求URL

GET /category/bid/{bid}

参数类型:请求体

|参数 |是否必选 |类型 |说明 |bid |Y |Long |图书id

返回结果

[ { id: 1, typeName: "玄幻"， typeInfo: "这个分类是玄幻", iconUrl:"" }, { id: 3, typeName: "爱情"， typeInfo: "这个分类是爱情", iconUrl:"" }, { id: 14, typeName: "轻小说"， typeInfo: "这个分类是轻小说", iconUrl:"" }, ]

状态码：

200：查询成功400：参数有误500：服务器内部异常

1.3 分类添加

请求URL

POST /category

参数类型:请求体

|参数 |是否必选 |类型 |说明 |typeName |Y |String |分类名 |typeInfo |N |String |分类描述 |iconUrl |N |String |分类图标

返回结果

无

状态码：

201：添加成功

400：参数有误

500：服务器内部异常

1.4 分类删除

请求URL

DELETE /category

参数类型:请求体

|参数 |是否必选 |类型 |说明 |id |Y |Long |分类id

返回结果

无

状态码：

201：删除成功

400：参数有误

500：服务器内部异常

1.5 分类修改

请求URL

PUT /category

参数类型:请求体

|参数 |是否必选 |类型 |说明 |id |Y |Long |分类id |typeName |Y |String |分类名 |typeInfo |N |String |分类描述 |iconUrl |N |String |分类图标

返回结果

无

状态码：

201：修改成功

400：参数有误

500：服务器内部异常

1.6 分页查询图书信息列表

请求URL

GET /books/page

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |title |N |String |图书标题(模糊查询)|null |cid |N |Long |分类id |null |page |N |int |页码 |1 |rows |N |int |一页多少个 |6

返回结果

{ "total": 2, "totalPage": null, "items": [ { "id": 2, "title": "我有一个资源挂", "intro": "　　穿越异界，当大家都在忙着修行的时候，王烨：“聚仙草？不死药？我今天该吃哪一道？” 　　当大家都在忙着搜寻炼制法宝的灵材而不得时，“通灵仙金，万灵紫玉，这么多乱七八糟的，我该用什么炼制我的法宝呢？” 　　王烨有一个资源挂，从此再也不用为资源发愁……", "aId": 2, "bookComment": "【“2020玄幻王”主题征文】参赛作品", "image": "https://wedo.image.obs.cn-north-4.myhuaweicloud.com:443/亡不起-我有一个资源挂.jpg", "creatDate": "2020-09-30T16:00:00.000+0000", "chapterNumber": 49, "updateDate": "2020-09-30T16:00:00.000+0000", "state": false, "protagonist": "暂无主角信息", "cId": 1 }, { "id": 3, "title": "我能看见正确姿势", "intro": "　　赵路觉醒能够看见正确姿势的能力，他眼中的天地出现了变化。 “混元功正确姿势推演中……” 一道人影出现在赵路面前，演绎着混元功的正确修行姿势。 “烈焰刀法正确姿势同步率百分之九十九，刀刀烈火，肆虐天地。” “吞服消化碧灵丹正确姿势同步率百分百，丹药生效速度提高，利用率提高……” “抢饭正确姿势同步率百分百，一筷子夹起一盘大虾……” 直到有一天，赵路来到一座高山脚下，传说这座高山上刻写着一门十分强大的功法，但是十万年来却无一人修成。 “让我瞧瞧这一功法到底多么难，十万年来竟然没有一人能够修成……” 赵路自信一笑，开始推演。但是很快赵路看着推演的结果呆呆道：“怎么有两个人影……”", "aId": 3, "bookComment": "心潮澎湃，无限幻想，迎风挥击千层浪，少年不败热血！", "image": "https://wedo.image.obs.cn-north-4.myhuaweicloud.com:443/当风入碧霄-我能看见正确姿势.jpg", "creatDate": "2020-09-30T16:00:00.000+0000", "chapterNumber": 69, "updateDate": "2020-09-30T16:00:00.000+0000", "state": false, "protagonist": "暂无主角信息", "cId": 1 } ] }

状态码：

200：请求成功

400：参数有误

500：服务器内部异常

1.7 根据图书id查询图书信息()

GET /books/bid/{bid}

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |bid |Y |Long |图书id

返回结果

{ id:1, title:"吞噬星星", aId:1, image:"http://image.wedo.com/image/1.jpg", creatDate: 2019-01-20, updateDate: 2020-10-10, chapterNumber: 2010, protagonist: "罗飞", state: 1, hot:200000000, cId:1 }

状态码：

200：请求成功

400：参数有误

500：服务器内部异常

1.8 修改图书信息

请求URL

PUT /books

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |id |Y |Long |图书id |title |N |String |图书名 |aId |N |Long |作者id |image |N |String |图片地址 |creaDate |N |data |起更日期 |protagonist|N |String |主角名 |state |N |int |是否完结1:完结 0:未完结 |cId |N |Long |分类的id

返回结果

无

状态码：

201：请求成功

400：参数有误

500：服务器内部异常

1.9 添加图书信息

请求URL

POST /books

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |id |Y |Long |图书id |title |N |String |图书名 |aId |N |Long |作者id |image |N |String |图片地址 |creaDate |N |data |起更日期（格式：2020-10-09） |protagonist|N |String |主角名 |state |N |int |是否完结1:完结 0:未完结 |cId |N |Long |分类的id

返回结果

无

状态码：

201：请求成功

400：参数有误

500：服务器内部异常

1.10 删除图书信息

请求URL

DELETE /books

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |bid |Y |Long |图书id

返回结果

无

状态码：

201：请求成功

400：参数有误

500：服务器内部异常

1.11 根据图书id返回章节基本信息

请求URL

GET /chapter/page

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |bid |Y |Long |图书id |page |N |int |页码 |1 |rows |N |int |一页多少个 |30

返回结果

{ "total": 488, "totalPage": null, "items": [ { "id": 10565, "sequenceNum": 1, "title": "序章　『开始的余温』", "context": null, "bId": 144 }, { "id": 10566, "sequenceNum": 2, "title": "01　『无法使用的十元硬币』", "context": null, "bId": 144 }, { "id": 10567, "sequenceNum": 3, "title": "02　『不要得意忘形，神明如是说』", "context": null, "bId": 144 }, { "id": 10568, "sequenceNum": 4, "title": "03　『第一次见识到魔法』", "context": null, "bId": 144 }, { "id": 10569, "sequenceNum": 5, "title": "04　『膝枕的报恩』", "context": null, "bId": 144 }, { "id": 10570, "sequenceNum": 6, "title": "05　『你的名字是？』", "context": null, "bId": 144 }, { "id": 10571, "sequenceNum": 7, "title": "06　『第一次的终结』", "context": null, "bId": 144 } ] }

状态码：

200：请求成功400：参数有误500：服务器内部异常

1.12 根据章节id获取章节主要信息

请求URL

GET /chapter/cid/{cid}

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |cid |Y |Long |章节id

返回结果

{ id:10001, bId:1, sequenceNum:1, title:"罗飞", context: '　　　　天空湛蓝，就仿佛一块巨大的蓝色翡翠，盛夏的太阳仿佛一个大火球，高高悬挂在这块巨大翡翠之中，看太阳位置，估计也就下午三点左右。99<cite></cite>　　宜安区第三高中。31<cite></cite>　　“叮叮叮……”随着响亮的铃声响彻整个校园，顿时整个校园中响起一片喧哗声，各栋教学楼中便鱼贯涌出了大量的学生，三五成群说笑着朝校门口走去。12<cite></cite>　　“罗峰师兄！罗峰师兄！”一道粗厚的声音响起。20<cite></cite>　　“阿峰，有人喊你。”8<cite></cite>　　在学生人群当中，和同学一道走着的拿着书籍的青年，穿着普通蓝色运动服，身高大概一米七五，显得比较精瘦。此时他疑惑转头看去，喊他的是一名男生，身高大概有一米九，长的虎背熊腰，手臂更是粗壮的惊人。5<cite></cite>　　“你是？”罗峰疑惑看着来人，自己似乎不认识眼前人。2<cite></cite>　　这二人，一个壮硕的好似一头黑熊。而‘罗峰师兄’和普通人一般。2<cite></cite>　　论身高……4<cite></cite>　　这二人相差极大。可是这名虎背熊腰的男生，却显得有些拘谨，他仔细看了看他崇拜的‘罗峰师兄’，暗道：“看样子，传言没错，罗峰师兄，是挺好说话的。”4<cite></cite>　　“罗峰师兄，我，我有事想请罗峰师兄帮忙。”壮硕男忐忑道。1<cite></cite>　　“什么事？”罗峰一笑，说道。3<cite></cite>　　“我练拳的时候，出拳发劲，总是感觉不对，不知道师兄你有没有时间指点一下。”这壮硕男生，连说道，“按照武馆老师说的，以我的力气，按道理一拳可以打出强上50％的力道。可是，我出拳发劲，总是达不到那么高。”17<cite></cite>　　壮硕男生期盼看着罗峰。2<cite></cite>　　“哦，是这样……”罗峰略微停顿一下，点点头，“这样吧，这个星期的星期天下午，在武馆的时候你找我。”10<cite></cite>　　“谢师兄，谢师兄了。”这壮硕的男生连感谢道。3<cite></cite>　　罗峰笑了笑，就和自己的同学一道离开。1<cite></cite>　　目送着罗峰离去，壮硕男生露出兴奋之色，猛地一握拳，手臂上青筋暴突，兴奋低吼一声：“成功！”9<cite></cite>　　“罗峰师兄，竟然就这么容易答应了？”一名穿着校服的男生惊讶道。1<cite></cite>　　“传言果然没错，罗峰师兄是很好说话的，人也很好。”壮硕男生咧嘴笑道。2<cite></cite>　　“可是……不对啊，我们第三高中，五千名学生中，获得‘武馆高级学员’称号的，一共才三个。三名高级学员当中，另外两个‘张昊白’和‘柳婷’可都是很傲的，根本是不肯浪费时间指点我们的。”校服男生疑惑道，“罗峰师兄脾气竟然这么好？”21<cite></cite>　　现如今，整个世界上，各个国家地区，几乎每一个高中生，在接受文化教育之外，也会加入武馆，开发人体潜力。9<cite></cite>　　宜安区第三高中，三个年级，一共近五千名高中生。6<cite></cite>　　绝大多数，都是武馆的初级学员！只有极少数，是‘中级学员’。能获得‘高级学员’资格的，一共才三个人！5<cite></cite>　　“耳听为虚，眼见为实。哼哼，看到了吧？罗峰师兄和另外两个可不一样。”壮硕男生撇嘴道，“那个张昊白和柳婷，家里都是富豪。从小家里花了大量金钱去培养，才能有这么强。至于罗峰师兄，和他们可不同！”16<cite></cite>　　校服男生也点头：“我也听说了，罗峰师兄和我们一样，家里经济条件一般，住的还是廉租房呢。”9<cite></cite>　　“对，罗峰师兄，能走到今天这一步，可完全是刻苦修炼。靠自己一拳一脚练出来的。哪像张昊白他们两个。”壮硕男生握紧拳头，深吸一口气，“我的目标就是罗峰师兄，我一定要在四年内，也就是大学毕业前，通过武馆考核，得到武馆的‘高级学员’称号！”21<cite></cite>　　……2<cite></cite>　　此刻，他们谈论的那位罗峰师兄，正和一名运动服男生顺着学生人流，朝第三高中大门走去。3<cite></cite>　　“阿峰，啧啧，刚才那个请你指点‘出拳发劲’的大块头男生走的时候，还和他同学夸你呢。”运动服男生，不由笑了起来，“夸你人好，夸你好说话。”6<cite></cite>　　罗峰笑了笑：“怎么，魏文，你嫉妒了？”4<cite></cite>　　“嫉妒你？”魏文一摸鼻子，嘿嘿笑道，“你做梦吧。我是在感叹，那个大块头不知道他敬佩的‘罗峰师兄’真面目啊。我可记得清清楚楚……那次在武馆的比武台上，他敬仰的‘罗峰师兄’连挑三人，打的三名高级学员爬不起来。”18<cite></cite>　　罗峰一笑。2<cite></cite>　　那一战，的确是他的成名战。3<cite></cite>　　罗峰一拍魏文肩膀，笑道：“走吧，回家。”3<cite></cite>　　魏文肩膀故作夸张的一抖，连喊道：“阿峰，你轻点。你这一拍，我肩膀都快碎了！”3<cite></cite>　　“又装！”罗峰撇撇嘴，魏文是和他从小穿开裆裤，一起玩到大的死党。虽然不是亲兄弟，感情却也差不多。25<cite></cite>　　小学，初中，高中。4<cite></cite>　　一路走来，二人感情的确很深。11<cite></cite>　　“咦？”1<cite></cite>　　魏文忽然盯着前方，“阿峰，你看，是你暗恋的那位！”2<cite></cite>　　“嗯？”罗峰也连看去，只见远处校门口学生人群中，有一名穿着牛仔裤、浅白色polo衫的的马尾辫少女正沿着路边走着。35<cite></cite>　　罗峰心跳微微加速。3<cite></cite>　　心中掠过一个名字——徐欣！99<cite></cite>　　自己暗恋徐欣，这个秘密知道的人极少，不过好兄弟‘魏文’自然很早就知道了。4<cite></cite>　　高一的时候，自己和徐欣被分到一个班级，第一次看到徐欣，就觉得眼前一亮……于是，上课的时候，自己坐在后面，不知怎么回事，总是控制不住自己，情不自禁看向前面坐着的徐欣背影，就这么默默看着。21<cite></cite>　　只要能看到徐欣背影，就已经满足了。13<cite></cite>　　高二因为分班，导致高二、高三，自己和徐欣不再一个班级。可是每当看到徐欣时，总是忍不住看过去……2<cite></cite>　　“离高考只剩下一个月。”罗峰心中默默道，“过去我没勇气，也没时间去追女生谈恋爱。而现在最后一个月，大家都忙着高考复习，徐欣也是很要强的女生。怎么可能这时候分心谈恋爱？而且高考前最后一个月，我也不能分心，否则以后会后悔终生。”14<cite></cite>　　“算了，这暗恋……就将它当作记忆吧。”7<cite></cite>　　暗恋……4<cite></cite>　　很苦涩，还没有开花，却已经凋谢。27<cite></cite>　　罗峰只想默默将这一切放在心底。1<cite></cite>　　“让你追徐欣，你不追。现在离高考只剩下一个月了。”魏文摇头道，“以后怕再也见不到徐欣了。你以后，后悔都晚了。”2<cite></cite>　　“魏文，”罗峰摇摇头，“别说了，没获得‘武者’称号，我是不会分心谈恋爱的。”9<cite></cite>　　“兄弟，你够狠！”5<cite></cite>　　魏文竖起大拇指，“武者称号？我们整个高中五千人，都没一个能获得‘武者称号’。你竟然说，不获得武者称号，就不分心谈恋爱。牛，你牛！”5<cite></cite>　　“嗯？”罗峰忽然瞥了校门口另外五个人一眼，“张昊白？”10<cite></cite>　　在校门口学生人群中显得很惹眼的五个人，为首的青年身高足有一米八，穿着白色体恤衫，白色长裤，胸肌凸显的很明显。在他周围的四个人，或是身体壮硕，或是脸上有着刀痕，一看都是很凶悍的人物。而白衣白裤青年正是宜安区第三高中，三名武馆高级学员当中的一位——张昊白。4<cite></cite>　　“罗峰。”张昊白看了罗峰一眼，不由发出一声低哼。4<cite></cite>　　在整个高中如果说他张昊白最恨谁，显然就是这个罗峰！2<cite></cite>　　毕竟，获得‘武馆高级学员’称号的三人中，有一个是女的。男生中，就他们两个是武馆高级学员！4<cite></cite>　　而且，张昊白是有钱人家，而罗峰是普通人家，住着廉租房。4<cite></cite>　　学习成绩上——罗峰压张昊白一头！1<cite></cite>　　在武力上——罗峰、张昊白都获得‘高级学员’称号，而罗峰还曾经在武馆内，连战三名高级学员。打的那三人爬不起来，这被打的三人当中，其中之一就是‘张昊白’。那次他被打的掉了一颗牙！27<cite></cite>　　而在家庭条件上，张昊白家明显有钱！2<cite></cite>　　条件好，可学习成绩和武力，都被罗峰压一头。在学校，有人夸赞张昊白的时候，经常会有人拿罗峰出来比！7<cite></cite>　　怨气！5<cite></cite>　　张昊白对罗峰的怨气，实在太大。7<cite></cite>　　“我们走。”张昊白舔了一下牙齿，牙齿似乎隐隐作痛，那次他就被打的满嘴血，掉了一颗牙。1<cite></cite>　　“这张昊白，自武馆那次，被揍了一次，乖多了，再也不来招惹阿峰你了。”魏文目送张昊白几人远去，不由笑着和罗峰说道。9<cite></cite>　　张昊白？3<cite></cite>　　对于这纨绔子弟，罗峰从没有放在心上。7<cite></cite>　　“多一事不如少一事。”罗峰说着，便和魏文一道回家。7<cite></cite>　　回家途中。2<cite></cite>　　“滴——滴——”街道上，汽车的喇叭声时而响起。现如今，汽车用的能源都是‘电能’，至少街道旁闻不到那种汽油味了。42<cite></cite>　　“魏文，还有一个月就高考了。这一个月，我们可都得认真努力一把。”罗峰和魏文在人行道上走着，“武馆那边，可以暂时放松一点。每天做些恢复性训练即可，精力主要放在文化学习上。高考毕竟很重要，我们可都是学了十二年了。就看这一遭了。”9<cite></cite>　　“对啊，十二年文化学习，就这一场考试定乾坤。”魏文也感叹一声，“高考啊高考，可是千军万马过独木桥。”34<cite></cite>　　“嗯。”罗峰也点点头。2<cite></cite>　　他家里的经济条件不算好，虽然他‘武馆高级学员’称号，注定他罗峰就是文化成绩再差，也能混一份‘精英保镖’的工作，年薪二三十万不成问题。可是……罗峰岂会甘心只是当一个保镖？25<cite></cite>　　……5<cite></cite>　　此时的宜安区上空，大概一千米高空。3<cite></cite>　　一头巨大的黑冠金雕正从城市高空飞行而过，它的身体约莫有二十余米长，就仿佛一架大型战斗机，全身羽毛隐隐泛着冰冷的金属光泽，头顶羽毛为幽黑色，就仿佛黑色皇冠一般，它那锋利巨大的利爪也是金黄色。11<cite></cite>　　一双泛着蓝光的锐利冰冷双眸，朝下方的人类城市俯瞰，竟然隐隐有着一丝杀意。3<cite></cite>　　“轰！”1<cite></cite>　　原本飞行速度已经很快的黑冠金雕，速度猛然大涨，瞬间突破音障，达到一个骇人的速度。同时，一道高亢之极的雕鸣声从黑冠金雕口中爆发，可怕的声波竟然产生肉眼可见的冲击波，朝下方迅速幅散开去。2<cite></cite>　　宜安区的白田路的一个十字路口，罗峰正和魏文等红绿灯。1<cite></cite>　　忽然——1<cite></cite>　　“昂——”5<cite></cite>　　一道刺耳之际的鸣叫声猛然响起，这声音和春雷炸响的声音不一样，雷的声音很大，震耳欲聋！而这高亢的鸣叫声却是刺耳，罗峰只感到耳朵鼓膜都是隐隐疼痛，不由有些难受皱起眉头。路上不少行人都捂住耳朵。2<cite></cite>　　“是飞禽鸣叫声音。”罗峰不由抬头看天。6<cite></cite>　　“嗯？”罗峰一惊。1<cite></cite>　　高亢刺耳的鸣叫声音震荡下，旁边街道的一座摩天大楼上一块块巨大的玻璃，发出低沉的“卡－卡－－”声音，不少玻璃龟裂开来，甚至于当场有十多块玻璃从高空掉落了下来，有的玻璃砸在人行道上，或是砸到人，有的则是砸到路旁的路灯。4<cite></cite>　　“啪！”“蓬！”“噼啪！”……6<cite></cite>　　一时间一阵炸裂声。1<cite></cite>　　其中就有一块玻璃砸落在罗峰旁边的路灯上，当场就碎裂朝四周迸射开去，令不少行人连闪避。1<cite></cite>　　“哇！”魏文连暴退两步，闪躲碎玻璃。1<cite></cite>　　其中一块玻璃碎片，仿佛刀片射向罗峰。3<cite></cite>　　“嗯？”罗峰目光一扫。3<cite></cite>　　并没有闪躲，而是平静站在原地，右手闪电般伸出，瞬间抓出这迸射过来的碎玻璃。这玻璃碎块隐约映照出罗峰的样子，掂了两下，随手一扔，碎玻璃仿佛暗器一样直接射向远处的垃圾箱，哐当一声，准确的从垃圾箱口射进。19<cite></cite>　　马路上，受到影响的车流很快恢复正常，而人行道上的行人们却是议论纷纷，有些倒霉的人受伤了，可是大多数人却是一点伤势没有。2<cite></cite>　　“好厉害。”罗峰不由仰头看了看天空，“在高空的一声鸣叫，竟然就有这么厉害。恐怕是极为厉害的飞禽怪兽。魏文。你不是对各种怪兽熟悉的很嘛，知道这是什么怪兽不？”9<cite></cite>　　魏文眯着眼，双眼缝隙中透着兴奋的光芒：“阿峰，我们城市高空五百米有防御系统，这飞禽怪兽绝对在五百米高空之上，这么远距离，发出的声音，还能有这么大的威力。而且一般怪兽，也不敢在人类城市上空这么叫嚣！”9<cite></cite>　　“这么厉害，这么嚣张，再根据声音，如果我猜测的不错……应该就是飞禽怪兽中，极为可怕的‘黑冠金雕’！”魏文郑重道。11<cite></cite>　　“黑冠金雕？”罗峰眼睛一亮。4<cite></cite>　　他当然听说过黑冠金雕的大名。2<cite></cite>　　“黑冠金雕，在雕类怪兽中排第三。”魏文双眸放光，低沉道，“成年体的黑冠金雕，体长一般达到21米，翼展在36米左右，飞行时极速可以达到3.9马赫。那可是足足3.9倍音速。音速按照一秒340米计算的话，就是一秒1326米，也就是一小时4774公里。”49<cite></cite>　　罗峰知道黑冠金雕厉害，可是听到一秒1326米的极限速度，依旧感到心中屏息。6<cite></cite>　　一秒钟，也就是眼睛一眨啊。就一千米开外了。35<cite></cite>　　“这黑冠金雕，羽毛比金刚石还要坚硬，应该达到三级克罗合金的硬度。”魏文兴奋连道，“网上可是有视频的，黑冠金雕曾经随怪兽群冲击过军队，遭受到口径20mm的火神炮轰击，火神炮可是一分钟7000发子弹，7000发子弹啊，那可是子弹金属流！而且每一发都能轰穿50毫米厚的钢板，可是……火神炮的疯狂轰击，轰击在黑冠金雕身上，竟然连一片羽毛都没轰击掉下来。”18<cite></cite>　　“后来，还是一名神秘武者强者，手持一柄克罗合金战刀，化作一道流光，将黑冠金雕一刀劈成两半！”魏文说的热血沸腾。19<cite></cite>　　罗峰也是心跳加速，血脉贲张！9<cite></cite>　　那一段视频，在网上传播的很广，他也看到过。1<cite></cite>　　“武者称号，我一定会获得武者称号，终有一天……我也要像那位前辈一样，能手持战刀，力劈黑冠金雕，大力魔猿这等怪兽。”罗峰在心中默默道，每一个年轻人心中都有一个梦想，罗峰心中就有着这样的梦想！16<cite></cite>　　虽然说……1<cite></cite>　　网络上称，那位一刀就将黑冠金雕劈成两半的神秘强者，在整个国际上，都是排名前100的超级武者！34<cite></cite>　　“阿峰，阿峰，你想什么呢？前面到家了。”魏文不由喊道。2<cite></cite>　　罗峰这才从澎湃的思绪中恢复过来，抬头看向前面由大量筒子楼组成的小区——南岸小区，一座由政府建造的廉租房小区，罗峰的家就在这个小区，一个他生活了十八年的地方。38<cite></cite>　　 '; },

状态码：

200：请求成功400：参数有误500：服务器内部异常

1.13 添加图书章节信息

请求URL

POST /chapter

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |bId |Y |Long |图书id |title |N |String |章节名 |context |N |String |章节内容 |frontSequenceNum|N |Long |上一章的章节序号 |null(传的话代表插入，不传的话代表在末尾插入)

返回结果

无

状态码：

201：请求成功

400：参数有误

500：服务器内部异常

1.14 修改图书章节信息

请求URL

PUT /chapter

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |id |Y |Long |章节id |title |N |String |章节标题 |context |N |String |章节内容

返回结果

无

状态码：

201：请求成功

400：参数有误

500：服务器内部异常

1.15 删除图书章节信息

请求URL

DELETE /chapter

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |id |Y |Long |章节id

返回结果

无

状态码：

201：请求成功

400：参数有误

500：服务器内部异常

1.16 根据分类id查询分类信息

请求URL

GET /category/cid/{cid}

参数类型:请求体

|参数 |是否必选 |类型 |说明 |cid |Y |Long |分类id

返回结果

{ id: 1, typeName: "玄幻"， typeInfo: "这个分类是玄幻", iconUrl:"" }

状态码：

200：查询成功400：参数有误500：服务器内部异常

1.17 根据分类id查询图书信息

请求URL

GET /books/pageByCid

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |cid |L |Long |分类id |null |page |N |int |页码 |1 |rows |N |int |一页多少个 |6

返回结果

[ { id:1, title:"吞噬星星", image:"http://image.wedo.com/image/1.jpg" }, { id:1, title:"吞噬星星", image:"http://image.wedo.com/image/1.jpg" }, { id:1, title:"吞噬星星", image:"http://image.wedo.com/image/1.jpg" }, { id:1, title:"吞噬星星", image:"http://image.wedo.com/image/1.jpg" }, { id:1, title:"吞噬星星", image:"http://image.wedo.com/image/1.jpg" }, { id:1, title:"吞噬星星", image:"http://image.wedo.com/image/1.jpg" } ]

状态码：

200：查询成功400：参数有误500：服务器内部异常

1.18 根据作者id查询图书信息

请求URL

GET /books/pageByAid

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |aid |Y |Long |作者id | |page |N |int |页码 |1 |rows |N |int |一页多少个 |6

返回结果

状态码：

200：查询成功400：参数有误500：服务器内部异常

1.19 根据图书id查询图书热度信息

请求URL

GET /hot

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |bid |Y |Long |图书id

返回结果

{ "bId": 144, "clickNum": 0, "searchNum": 0, "hot": 0 }

状态码：

200：查询成功400：参数有误500：服务器内部异常

1.20 修改图书热度信息

请求URL

PUT /hot

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |bId |Y |Long |图书id |clickNum |N |Long |点击量 |searchNum |N |Long |搜索量 |hot |N |Long |热度

返回结果

无

状态码：

201：修改成功400：参数有误500：服务器内部异常

1.21 获取作者

请求URL

GET /author

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |aId |Y |Long |作者id

返回结果

{ "id": 143, "name": "长月达平", "introduce": "暂无简介信息", "aPhoto": null }

状态码：

200：请求成功400：参数有误500：服务器内部异常

1.22 添加作者

请求URL

POST /author

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |name |Y |String |作者名 |introduce |N |String |作者简介 |aPhoto |N |String |照片

返回结果

无

状态码：

201：请求成功400：参数有误500：服务器内部异常

1.23 修改作者

请求URL

PUT /author

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |id |Y |String |作者id |name |N |String |作者名 |introduce |N |String |作者简介 |aPhoto |N |String |照片

返回结果

无

状态码：

201：请求成功400：参数有误500：服务器内部异常

1.24 删除作者

请求URL

DELETE /author

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |id |Y |String |作者id

返回结果

无

状态码：

201：请求成功400：参数有误500：服务器内部异常

1.25 分页查询作者

请求URL

GET /author/page

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |name |N |String |作者名(模糊查询) |page |N |int |页码 |1 |rows |N |int |一页有多少个 |6

返回结果

{ "total": 5, "totalPage": null, "items": [ { "id": 25, "name": "长安夜九", "introduce": "暂无简介信息", "aPhoto": null }, { "id": 50, "name": "一声长笛", "introduce": "暂无简介信息", "aPhoto": null }, { "id": 67, "name": "水长东x", "introduce": "暂无简介信息", "aPhoto": null }, { "id": 96, "name": "蔡家长子", "introduce": "暂无简介信息", "aPhoto": null }, { "id": 143, "name": "长月达平", "introduce": "暂无简介信息", "aPhoto": null } ] }

状态码：

200：请求成功400：参数有误500：服务器内部异常

1.26 根据分类图书信息(按热度排序)

请求URL

GET /books/pageByCidAndHot

参数类型:请求体

|参数 |是否必选 |类型 |说明 |默认 |cid |Y |Long |分类id | |rows |N |int |一页有多少个 |4

返回结果

[ { "id": 5, "title": "修炼从万界直播卖货开始", "intro": "　　【灵气复苏+系统+万界穿越+直播卖货+异界入侵】穿越到平行世界的苏源有些懵逼，他发现自己穿越的方式有点问题，修炼废柴也就算了，蓝星还被无数异界入侵了？不行！我要直播！我要卖货！我要把万界的丹药、功法、宝物……全部直播卖出去，带领蓝星一起装逼一起飞！修炼废柴？我有易筋经！没有觉醒异能？我有恶魔果实！你是召唤师？来吧，召唤卡，我不但能够召唤钢铁侠、张三丰，还能召唤孙悟空和狠人大帝！", "aId": null, "bookComment": null, "image": "https://wedo.image.obs.cn-north-4.myhuaweicloud.com:443/游尘-修炼从万界直播卖货开始.jpg", "creatDate": null, "chapterNumber": null, "updateDate": null, "state": null, "protagonist": null }, { "id": 4, "title": "开局就有顶级剑道天赋", "intro": "　　你开启剑者模板，获得这方世界顶级的剑道天赋。你开始修炼凡阶上品品质的剑法-剑竹三剑。第一遍，你已经堪比学了此剑法一月的新手；第二遍，你已经堪比学了此剑法半年的半新手；第三遍，你已经堪比学了此剑法一年的老手； …… 第十遍，你已经是堪比沉迷此剑法五年无法自拔的疯子；第二十遍，你的剑法剑竹三剑达到登峰造极的境界； …… 第五十遍，你的剑法剑竹三剑突破登峰造极境界，达到前所未有的天人合一境界，你领悟了零星剑意。", "aId": null, "bookComment": null, "image": "https://wedo.image.obs.cn-north-4.myhuaweicloud.com:443/剑剑中神-开局就有顶级剑道天赋.jpg", "creatDate": null, "chapterNumber": null, "updateDate": null, "state": null, "protagonist": null }, { "id": 1, "title": "吞噬星空之诸天地下城", "intro": "　　当诸天成为地下城，当剧情成为副本地图！当那些曾经无敌的主角，都沦为不停被“杀”的BOSS！只有他，才是吞噬星空第一鬼剑王、炼器王、混沌太上皇！当然，他还有一个响亮却不为人知的称号——起源大陆联合酋长国酋长！【纯武者流，中期有少量御剑手段，后期先不说】【文风偏向番茄，以正为主；不偷不抢，主角有自己的机缘】", "aId": null, "bookComment": null, "image": "https://wedo.image.obs.cn-north-4.myhuaweicloud.com:443/夜色下的蜉蝣-吞噬星空之诸天地下城.jpg", "creatDate": null, "chapterNumber": null, "updateDate": null, "state": null, "protagonist": null }, { "id": 2, "title": "我有一个资源挂", "intro": "　　穿越异界，当大家都在忙着修行的时候，王烨：“聚仙草？不死药？我今天该吃哪一道？” 　　当大家都在忙着搜寻炼制法宝的灵材而不得时，“通灵仙金，万灵紫玉，这么多乱七八糟的，我该用什么炼制我的法宝呢？” 　　王烨有一个资源挂，从此再也不用为资源发愁……", "aId": null, "bookComment": null, "image": "https://wedo.image.obs.cn-north-4.myhuaweicloud.com:443/亡不起-我有一个资源挂.jpg", "creatDate": null, "chapterNumber": null, "updateDate": null, "state": null, "protagonist": null } ]

状态码：

200：请求成功400：参数有误500：服务器内部异常

上一篇：唯读—实体以及表结构设计下一篇：唯读—项目搭建

Processed: 0.009, SQL: 8