8.7 KiB
1：接口说明
测试阶段接口基地址：
- 1：App数据接口：http://127.0.0.1:8090/app
- 2：后台数据接口：http://127.0.0.1:8090/admin
正式阶段接口：（前端用这个）
- 1：App数据接口：https://moehu.net/app
- 2：后台数据接口：https://moehu.net/admin
接口文档地址：
返回数据格式如下：
{
"code": 操作的状态码,
"message": 操作的提示信息,
"data": 返回的具体数据
}
注意：
code 取值有：
- 200：表示成功获取到
data数据 - 100：表示操作成功，但是不需要返回data数据给前端，所以
data == null，只是返回一个操作状态的文字提示（例如用户修改，删除） - 404：表示没有获取到
data数据，所以返回错误的具体信息。 - 500：表示系统级别的错误，一般后端程序出错，缺少
token，或者用户不存在等 - 403：表示token失效，需要前端重定向登录页面重新登录
前端根据 code 的取值的不同需要自行在拦截器里面处理各种情况，一般建议如下处理：
code == 200：返回data中的数据给前端页面使用code == 100：不返回数据给前端页面，不需要toast提示用户code == 404：不返回数据给前端页面，但需要toast提示用户code == 500：不返回数据给前端页面，但需要弹窗提示用户！code == 403：不返回数据给前端页面，但需要弹窗提示用户，强制用户进行某些操作！
1：任务计划
前台App功能
- 1：集成接口文档 【完成】
- 2：实现接口调用日志【完成】
- 3：Nodejs+Shell 实现 自动化部署【完成】
- 4：接口token 【完成】
- 5：实现接口限流
- 6：查看作品详情接口
- 6.1：作品的主要数据 【完成】
- 6.2：获取 该作品 评论 的数据 【完成】
- 6.3：获取 该作品 发布用户信息 的数据 【完成】
- 6.4：获取 该作品 标签 的数据，关联任务8 【完成】
- 6.5：点赞接口，取消点赞接口，查询作品是否被点赞接口 【完成】
- 说明：用户可以在点赞的界面，取消点赞。用户不可以用查看点赞过的作品
- 6.6：收藏作品相关的功能
- 收藏接口 【完成】
- 取消收藏接口 【完成】
- 个人空间获取收藏列表接口。【完成】
- 简单版的作品详情接口（只返回作品图片）
- 说明：用户只可以在个人空间中查看收藏的作品（功能类似于个人相册） 该相册中查看已收藏的作品，查阅作品时不会跳转到之前点赞收藏的页面，而是独立的简单的图片预览，类似手机自带相册的预览方式。
-
7：发布评论接口【完成】，获取评论列表【完成】，删除评论接口【完成】 和 举报他人评论接口
- 说明：用户评论发布后，可以在发布评论的地方进行删除评论，如果是他人的评论可以对他人的言论进行举报，并备注举报理由
- 8：发布作品（作品是画（图片）） 接口
- 8.1：上传文件接口 【完成】
- 8.2：获取推荐标签接口 【完成】
- 8.3：创建标签接口 【完成】备注：需要在创建作品成功后调用创建标签的service方法
- 8.4：获取作品的标签 接口 【完成】
- 8.5：点击标签，查看该标签下作品列表 接口 【完成】
- 8.6：用户创建的标签自己可以编辑删除，管理员可以后台进行删除操作
- 获取用户自己创建的所有标签 【完成】
- 修改创建的标签 【完成】
- 删除创建的标签 【完成】
- 9：搜索接口
- 说明
- 关联 2.3
- 说明
- 10：登录，注册，短信验证等接口
- 说明：
- 短信验证码阿里云未通过审核
- 登录注册需要对接需求后修改
- 说明：
-
11：首页获取 推荐 列表的接口 【完成】
- 说明：
- 按照最新发布的作品进行排序，水平比较低的，可以再审核的那一环，选择不展示再首页的最新推荐中
- 说明：
-
12：首页获取 排行 列表的接口 【完成】
- 说明：
- 排行 按照 点赞量 收藏量 下载量 评论量 还自定义算法
- 作品点赞数×0.1+作品浏览量×0.2+作品的关注数量×0.15+评论量×0.2=权重分数
- 说明：
-
13：首页获取 关注 列表的接口 【完成】
- 说明：
- 只展示自己关注用户的作品
- 说明：
-
14：修改资料接口
- 说明：
- 需要详细PSD，和进一步需求沟通
- 说明：
-
15：联系客服 集成第三方
-
16：关注作品接口，取消关注接口，查询当前用户是否被关注接口 【完成】
- 说明：可以取消关注，可以在任何有关注该用户的地方，重新点击已关注的按钮，进行取消关注（关注某个用户，关注按钮会默认变为已关注）关注列表中也可以快捷取消关注
后台功能
- 1：作品审核
- 2：头像审核
- 3：昵称审核
- 4：签名审核
说明：这三个可以先通过，审核不过可以再驳回，因为这个肯定是要管理的。
- 5：作品举报审核
- 6：热门推荐顺序
2：需求沟通整理
2.1：动态和作品有什么区别？
作品是画（图片），可以点赞 收藏 付费下载
动态就是类似于朋友圈 空间说说，动态（类似于朋友圈 空间说说）分两种情况
1：个人空间中动态：展示用户自己发的动态
2：首页底部中动态：展示用户关注人的动态
1：用户发布作品的时候
功能：是否勾选【同步至动态】按钮
结果1（投稿动态）：勾选后，那么该作品将同时出现在 动态 和 作品中，并且可以在标签，搜索，排行中等功能中正常被使用到
牵连的功能：如果动态列表中的 【投稿动态】 被点击，那么直接进入作品详情页面来查看作品
结果2（普通动态）：未勾选，那么该作品只会出现动态中。
牵连的功能：如果动态列表中的 【普通动态】 被点击，那么应该进入动态详情页面来查看动态
2.2：那么动态是否需要做成类似作品那样？用户可以发布自己的动态？对自己的动态进行删除修改？动态是否也需要作品那样的评论，点赞，举报等一些列功能？
用户可以在个人空间发布自己的动态，自己的动态如果添加（标签/话题）就会在动态中心被搜索，如果不添加，仅展示给已关注我的人，或者是好友（好友属于后续阶段的社交功能），但是如果别人进入了个人空间，动态都是任何访客都可预览的，动态中心的动态，和个人空间的动态。都和发布作品一样的评论功能，可以留言，可以举报（动态可以删除，但是不了修改内容，只能重发）
2.3：作品只有一张图，更多图片可以去个人空间阅览
没看明白具体意思，未详细沟通需求！
2.4：首页的搜索针对作品进行吗？如果针对作品，那么提供哪些关键词搜索方式？作品名，作者名 还是？
首页的搜索，可以搜索作品名，角色名，游戏名，番剧名，（标签/话题），作者昵称，作者id，作品id
2.5：我的空间，动态 等页面也有搜索功能，问题同 2.4！
未详细沟通需求！
3：需要客户提供的资料
3.1 暂缺的PSD图：
- 1：首页的排行 【已提供】
- 2：动态的发布页面 【已提供】
- 3：登录，注册 【已提供】
- 4：编辑资料点进去页面 【已提供】
- 5：首页顶部搜索输入框点击进入后的页面 【已提供】
- 6：抽屉里面的设置页面 【已提供】
- 7：标签管理页面 【已提供】
- 8：动态的详情页面 【已提供】
- 9：首页 关注页面
- 10：首页，动态 搜索后的列表页面
- 11：主题页面
- 12：各个动态页面 右上角 图标 点开后 样式
3.2 第三方资料和配置
-
1：服务器 【完成】
-
2：存片存储 （阿里云oss 或者 七牛云）【完成】
-
3：HTTPS 证书的开通 【完成】
-
6：申请域名（注册阿里账号，域名备案）【完成】
-
4：短信验证码 平台 【审核】
-
9：android 平台上架申请账号 【正在进行】
-
5：微信 & 支付宝支付 申请 【可以同步开始】
-
7：第三方客服
-
8：苹果开发者证书
3.3 客户基本信息
- 应用名称：萌弧
- 公司名称：安徽虚拟纪元科技有限公司
- 已备案的网站：没有