安卓课设——新闻阅读器
实现了:登录、注册、新闻详情
- 要求数据从云端拉取,于是顺便写了新闻的接口。Spring Boot编写挺快的。
- 开放下面的接口给需要的朋友练习
- 文档原先是用语雀写的(语雀的体验真的非常好),现在有空就顺便粘贴过来的。
注意:当你看到这篇文章时,请点击这里测试是否可用,如果看到一串JSON,说明可用。永远不知道,明天和停止维护,还有多远。
新闻API文档
约定
- Content-Type为
application/x-www-form-urlencoded
,通过urlencode
格式化请求体。 - 响应报文为
JSON
注册
接口描述:用户注册,必要的参数:用户名,密码
HTTP 方法:POST
请求URL:https://challage.cn/guet/api/user/register
注册请求说明
参数 | 是否必需 | 长度范围 | 说明 |
---|---|---|---|
userName | 是 | 0-50 | 用户名 |
userPassword | 是 | 0-50 | 密码 |
userNikeName | - | 0-50 | 昵称 |
userImg | - | 0-50 | 头像URL (需要存储接口配合,暂缺省) |
userMore | - | 0-50 | 预留字段,可用作自我介绍等 |
注册返回说明
参数 | 是否必需 | 值说明 |
---|---|---|
registerMsg | 是 | 注册结果信息 |
userId | 是 | 成功时返回userId,失败时返回-1 |
注册成功示例(userId>0):
请求参数:
userName:张三userPassword:407
响应:
{ "registerMsg": "注册成功", "userId": 62}
注册失败示例(userId == -1):
请求参数:
userName:张三userPassword:407
响应:
{ "registerMsg": "用户名已存在", "userId": -1}
注册参数不合法示例(userId == -1):
请求参数:
userName:张三userPassword:null
响应:
{ "registerMsg": "用户名和密码不能为空", "userId": -1}
登录
接口描述:用户登录,必要的参数:用户名,密码
HTTP 方法:POST
请求URL:https://challage.cn/guet/api/user/login
返回说明
参数 | 是否必需 | 值说明 |
---|---|---|
loginMsg | 是 | 登录结果信息 |
userInfo | 是 | 成功时返回用户POJO,登录失败时为null |
登录成功示例(注意,因为返回用户POJO映射,考虑安全而将密码置空):
请求参数:
userName:panuserPassword:123456
响应:
{ "loginMsg": "登录成功", "userInfo": { "userId": 1, "userName": "pan", "userPassword": null, "userNikeName": "潘裤衩", "userImg": "https://upload.jianshu.io/users/upload_avatars/2027280/6f5e986b-1eec-45c7-a512-4b51854595d9.jpg?imageMogr2/auto-orient/strip|imageView2/1/w/96/h/96", "userRegisterTime": "2019-06-12 22:45", "userMore": "自我介绍~" }}
登录失败响应示例:
请求参数
userName:panuserPassword:666
响应
{ "loginMsg": "登录失败,用户名或密码错误", "userInfo": null}
登录参数不合法响应示例:
请求参数:
userName:panuserPassword:null
响应:
{ "loginMsg": "登录失败,用户名或密码错误", "userInfo": null}
获取新闻详情
接口描述:通过 news_id 获取新闻详情
HTTP 方法:POST/GET
请求URL:https://challage.cn/guet/api/news/detail/news_id
参数以 RESTFUL 格式携带于URL中,news_id
为 Integer 类型参数
例如 https://challage.cn/guet/api/news/detail/2
含义:new_id 为2的新闻详情
响应结果说明:
参数 | 是否可能为空 | 说明 |
---|---|---|
newsId | 否 | news_id |
newsTitle | 否 | 标题 |
newsSubtitle | 是 | 副标题 |
newsAuthor | 是 | 作者 |
newsCover | 是 | 封面图URL |
newsType | 是 | 新闻类型 |
newsPublishTime | 是 | 新闻发布时间 |
newsContent | 否 | 新闻内容 |
newMore | 是 | 预留字段 |
新闻返回成功示例:
请求参数: https://challage.cn/guet/api/news/detail/2
{ "newsId": 2, "newsTitle": "刘鹤:中国经济长期向好趋势不变 外部压力有利发展", "newsSubtitle": "原标题:刘鹤:中国经济长期向好的趋势不会改变,外部压力有利发展", "newsAuthor": "中国经济网", "newsCover": "https://imgsa.baidu.com/news/q%3D100/sign=6dfce06a5fda81cb48e687cd6267d0a4/3812b31bb051f819468a0bd4d4b44aed2f73e785.jpg", "newsType": "经济", "newsPublishTime": "2019-06-13 11:27", "newMore": "缺省字段", "newsContent": "在第十一届陆家嘴论坛上,国务院副总理刘鹤表示,中国经济长期向好的趋势不会改变,外部压力有利发展。\r\n\r\n他说,要加大金融对经济高质量发展的支持,这件事至关重要,中国经济已经从高速增长阶段转变为高质量发展阶段。\r\n\r\n一是供给体系要不断优化。40年改革开放中国已经形成完整的产业体系,进入新的发展阶段,需要我们深化供给侧结构性改革,强化公平的市场环境,增强科技创新在经济发展中的作用,增强企业家在经济发展中的引领作用,大力提高制造业、服务业,形成国际分工产业链的完整性,使现代产业大趋势进一步延伸。\r\n\r\n二是需求体系需要进一步升级。庞大的中等收入群体正在形成,我国目前中等收入有4亿,有住房汽车稳定工作,需求各具特色,高度重视质量。目前中国已是全世界最大的成长性市场,为全世界提供机会。\r\n\r\n三是金融体系要高质量适配。目前金融正在进行供给侧改革,要加大直接融资比例,提高金融适应性、竞争性、普惠性。\r\n\r\n他指出,供给、需求和金融是三角框架,在全球化背景下,它们是开放的系统而不是封闭的系统。三者相互支撑的过程中,中国经济形成了良好态势,中国经济再平衡正在持续推进,取得了全面进展。\r\n\r\n他表示,下一阶段金融工作主要聚焦几个方面:\r\n\r\n第一, 回归本源,坚定服务实体经济,提高金融供给的适应性。第二, 打好防范化解金融风险攻坚战,注意把握好处置风险的力度和节奏。第三, 实施好金融调控,加强货币政策、宏观审慎政策、微观审慎监管的协调配合。第四, 强化金融基础设施建设。统筹规划,加强信息共享。第五, 进一步加快改革开放。加快推进市场准入、平等竞争、保护产权和知识产权。\r\n\r\n他透露,这次论坛上,有关部门将宣布一系列金融改革开放的举措。"}
新闻返回失败示例:
请求参数: https://challage.cn/guet/api/news/detail/25
null
获取最新20条新闻
预留开发
新闻收藏
预留开发