发表于： 2020-09-07 01:06:45
1 1444
今天完成的事情：分工完成接口的定义。我做的是签到，留言板，树洞。
听说明天邵博师兄回来了，兴奋。
明天计划的事情：明天一起商量接口的参数，进行方案设计
遇到的问题：有些细节的定义需要明天商量下
收获：
签到
签到数新增
POST /a/u/signin/{id}
请求参数
字段 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| uid | int | 是 | 用户id |
返回参数
字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| code | num | code码 | |
| message | string | 返回信息 |
签到数查询
GET /a/u/signin/{id}
请求参数
字段 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| uid | int | 是 | 用户id |
返回参数
字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| code | num | code码 | |
| message | string | 返回信息 | |
| data | object | 签到对象 |
data
字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| cout | int | 总签到数 | |
| continueSign | int | 连续签到数 | |
| userName | String | 用户昵称 | |
| userImg | String | 用户头像 | |
| bean | int | 逆袭豆 |
树洞
树洞新增
POST /a/u/tree
请求参数
字段 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| uid | int | 是 | 用户id | |
| content | String | 是 | 内容 | 80字以内 |
返回参数
字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| code | num | code码 | |
| message | string | 返回信息 |
树洞前台查询
GET /a/u/tree
返回参数
字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| code | num | code码 | |
| message | string | 返回信息 | |
| data | object | 签到对象 |
data
字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| content | String | 树洞内容 | |
| like | int | 点赞数 | |
| dislike | int | 踩数 |
最热树叶
GET /a/u/tree?pagesize=10
请求参数
字段 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| pagesize | int | 是 | 按照热度，查询前10个 |
返回参数
字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| code | num | code码 | |
| message | string | 返回信息 | |
| data | object | 签到对象 |
data
字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| content | String | 树洞内容 | |
| like | int | 点赞数 | |
| dislike | int | 踩数 |
留言板
留言新增
POST /a/u/message
请求参数
字段 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| uid | int | 是 | 用户id | |
| class | int | 是 | 年级 | 0为初中部，1为高中部 |
| head | String | 是 | 标题 | 20字以内 |
| content | String | 是 | 留言内容 | |
| img | String | 否 | 图片上传 |
返回参数
字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| code | num | code码 | |
| message | string | 返回信息 |
留言查询
GET /a/u/tree/{status}
请求参数
字段 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| status | int | 是 | 查询状态 | 0为前台精华查询，1为查询所有 |
返回参数
字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| code | num | code码 | |
| message | string | 返回信息 | |
| data | object | 签到对象 |
data
字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| mid | String | 树洞内容 | |
| head | String | 标题 | |
| createBy | String | 创建人 | |
| createAt | long | 创建时间 | |
| class | int | 年级 | 0为初中部，1为高中部 |
| read | int | 阅读数 | |
| remarkNum | int | 评论数 | |
| like | int | 精华贴 | 0为是，1为不是 |
| img | String | 图片 | |
| remark | object | 评论对象 |
留言删除
DELETE /a/u/tree/{id}
请求参数
字段 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| id | int | 是 | 留言id |
返回参数
字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| code | num | code码 | |
| message | string | 返回信息 |
评论新增
POST /a/u/remark
请求参数
字段 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| uid | int | 是 | 评论id | |
| createBy | String | 是 | 创建人 | |
| createAt | long | 是 | 创建时间 | |
| content | String | 是 | 内容 | 350字以内 |
返回参数
字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| code | num | code码 | |
| message | string | 返回信息 |
评论删除
DELETE /a/u/remark/{id}
请求参数
字段 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| rid | int | 是 | 评论id |
返回参数
字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| code | num | code码 | |
| message | string | 返回信息 |
返回列表
评论