发表于： 2019-10-31 23:22:58
1 1079
今天完成的事情：
收藏，评论，浏览，点赞接口设计。
我的收藏(列表查询)（张明顺）
接口：/a/u/list/collection
请求方式：get
请求参数：
字段 | 说明 | 类型 | 是否必填 | 注释 |
|---|---|---|---|---|
| id | 用户id | Number | 否 | 自动获取 |
| type | 学习对象类型 | Number | 是 | 文章，视频 |
| page | 页数 | Number | 否 | |
| size | 行数 | Number | 否 |
返回参数：同通用样例
data:
字段 | 说明 | 类型 |
|---|---|---|
| studyId | 学习对象序号 | Number |
| collectionId | 收藏记录序号 | Number |
| cover | 封面 | String |
| title | 标题 | String |
| content | 文章内容 | String |
| price | 价格 | Number |
| discount | 折扣价格 | Number |
我的收藏删除-接口：/a/u/collection
请求方式：delect
请求参数：同通用样例
返回参数：同通用样例
我的收藏查看（查看学习对象）-接口：/a/u/study
请求方式：get
请求参数：同通用样例
返回参数：同通用样例
data:同学习对象详细查询
浏览记录(列表查询)（张明顺）-接口：/a/u/list/history
请求方式：get
请求参数：
字段 | 说明 | 类型 | 是否必填 | 注释 |
|---|---|---|---|---|
| type | 学习对象类型 | Number | 是 | 文章：10/视频：20 |
| page | 页数 | Number | 否 | 默认第一页 |
| size | 行数（每页记录数） | Number | 否 | 默认十条数据 |
返回参数：同通用样例
data:
字段 | 说明 | 类型 |
|---|---|---|
| studyId | 学习对象序号 | Number |
| historyId | 浏览记录序号 | Number |
| cover | 封面 | String |
| title | 标题 | String |
| content | 文章内容 | String |
| price | 价格 | Number |
| discount | 折扣价格 | Number |
浏览记录删除
接口：/a/u/study/history
请求方式：delect
请求参数：同通用样例
返回参数：同通用样例
浏览记录查看（查看学习对象）
接口：/a/u/study
请求方式：get
请求参数：同通用样例
返回参数：同通用样例
data:同学习对象详细查询
点赞（查看）-接口：/a/like
请求方式：get
请求参数：
字段 | 说明 | 类型 | 是否必填 | 注释 |
|---|---|---|---|---|
| type | 点赞类型 | Number | 是 | 学习对象：10，留言：20 |
| bizId | 根据类型根对应ID | Number | 是 | 学习对象ID，留言ID |
返回参数：同通用样例
data:
字段 | 说明 | 类型 |
|---|---|---|
| id | 序号（不为空，将返回点赞表ID，为空，当前用户未对对应学习对象或留言点赞，或当前用户未登录） | Number |
| likeCount | 点赞数 | Number |
点赞（新增）-接口：/a/u/like
请求方式：post
请求参数：
字段 | 说明 | 类型 | 是否必填 | 注释 |
|---|---|---|---|---|
| type | 点赞类型 | Number | 是 | 学习对象：10，留言：20 |
| id | 学习对象序号或留言ID | Number | 是 |
返回参数：同新增通用样例
点赞取消（删除）-接口：/a/u/like
请求方式：delect
请求参数：同通用样例
返回参数：同通用样例
浏览(新增)-接口：/a/u/history
请求方式：post
请求参数：
字段 | 说明 | 类型 | 是否必填 | 注释 |
|---|---|---|---|---|
| id | 学习对象序号 | Number | 是 |
返回参数：同新增通用样例
评价（评论）（列表查询）-接口：/a/list/comment
请求方式：get
请求参数：
字段 | 说明 | 类型 | 是否必填 | 注释 |
|---|---|---|---|---|
| id | 学习对象序号 | Number | 是 |
返回参数：同通用样例
data:
字段 | 说明 | 类型 |
|---|---|---|
| likeId | 点赞ID（如果此参数不为空，即此条留言当前用户点过赞） | Number |
| userId | 用户ID | Number |
| id | 序号 | Number |
| avatar | 头像 | String |
| name | 昵称（用户名） | String |
| content | 内容 | String |
| star | 星级 | Number |
| createAt | 创建时间 | Number |
| likeCount | 点赞数 | Number |
评价（评论）（新增）-接口：/a/u/comment
请求方式：get
请求参数：
字段 | 说明 | 类型 | 是否必填 | 注释 |
|---|---|---|---|---|
| id | 学习对象序号 | Number | 是 | |
| content | 留言内容 | String | 是 | |
| star | 星级（评价等级） | Number | 否 | 视频有，文章没有 |
返回参数：同通用样例
（待定）评价（评论）（删除）-接口：/a/u/comment
请求方式：delect
请求参数：同通用样例
返回参数：同通用样例
当前用户ID与评论用户ID相同时，才可删除当前评价。
收藏（详细查询）-接口：/a/collection
请求方式：get
请求参数：
字段 | 说明 | 类型 | 是否必填 | 注释 |
|---|---|---|---|---|
| id | 学习对象ID | Number | 是 |
返回参数：同通用样例
data:
字段 | 说明 | 类型 |
|---|---|---|
| id | 序号（不为空，将返回收藏表ID，为空，当前用户未对对应学习对象收藏，或当前用户未登录） | Number |
明天计划的事情：
点赞消息通知方案设计，支付接口设计
遇到的问题：
好评率是添加字段解决，还是随时计算。
收获：
返回列表
评论