发表于： 2020-08-01 23:19:59
1 1454
今天完成的事情：
1.理清垂纶小室前台的流程。
2.根据流程写接口文档。
3.设计数据表
流程
1.进入导入页,分配游客昵称。
2.进到首页，给导航数据和banner图。
3.进到搜索展示页，在搜索框输入作品标题或者作品简介的关键字,给搜索得出的所有作品。
4.进到作品展示页，选择对应的作品集，展示该作品集下所有的作品。
5.通过作品展示页选择一个作品，然后跳转到作品详情页，详情页包含作品的标题，简介，图片，游客留言，作者回复。
6.进入作者及工作室页，可以看到一个导航栏，导航栏包括艺术家简介，工作室简介，成员简介，点击对应的简介得到简介内容.
需要的接口
1.分配游客昵称接口
2.导航接口
3.banner接口
4.搜索接口
5.作品展示接口
6.查看作品详情接口
7.游客留言接口
8.作者回复接口
9.查看留言接口
10.查看简介接口
接口文档
简要描述
- 分配游客昵称接口
请求URL
- /task3/tourist/{id}
请求方式
- GET
请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| touristid | number | 是 | 游客id |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码 |
| message | string | 状态信息 |
| data | object | 数据 |
data:
| 字段 | 类型 | 说明 |
|---|---|---|
| nick | string | 游客昵称 |
简要描述
- 查看banner
请求URL
- /task3/banner/{bid}
请求方式
- GET
请求参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| bid | number | banner图id |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码 |
| message | string | 状态信息 |
| data | object | 数据 |
data:
| 字段 | 类型 | 说明 |
|---|---|---|
| image | string | banner图片链接 |
简要描述
- 搜索关键字接口
请求URL
- /task3/find/list
请求方式
- GET
请求参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| keyword | string | 关键字,只能输入作品名称或者作品简介包含的关键字 |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码 |
| message | string | 状态信息 |
| data | array | 数据 |
data:
| 字段 | 类型 | 说明 |
|---|---|---|
| name | string | 作品标题 |
| timage | string | 缩略图 |
| intro | string | 作品简介 |
简要描述
- 查看作品详情接口
请求URL
- /task3/works/{wid}
请求方式
- GET
请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| wid | number | 是 | 作品id |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码 |
| message | string | 状态信息 |
| data | object | 数据 |
data:
| 字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| name | string | 作品标题 | |
| intro | string | 作品简介 | |
| video | string | 视频 | |
| dimage | string | 详情图片 | |
| type | string | 作品类型 | 0图片,1视频 |
简要描述
- 作品展示接口
请求URL
- /task3/works/list
请求方式
- GET
请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| secondid | number | 是 | 作品集id |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码 |
| message | string | 状态信息 |
| data | array | 数据 |
data:
| 字段 | 类型 | 说明 |
|---|---|---|
| name | string | 作品标题 |
| intro | string | 作品简介 |
| timage | string | 缩略图 |
简要描述
- 查看留言接口
请求URL
- /task3/message/{mid}
请求方式
- GET
请求参数
| 参数名 | 类型 | 说明 | 是否必选 |
|---|---|---|---|
| mid | number | 留言id | 是 |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码 |
| message | string | 状态信息 |
| data | object | 数据 |
data:
| 字段 | 类型 | 说明 |
|---|---|---|
| nick | string | 游客昵称 |
| content | string | 评论内容 |
| messageTime | string | 评论时间 |
| name | string | 作者名字 |
| replyContent | string | 回复内容 |
| replyTime | string | 回复时间 |
简要描述
- 游客留言接口
请求URL
- /task3/message
请求方式
- POST
请求参数
| 参数名 | 类型 | 说明 | 是否必选 |
|---|---|---|---|
| nick | string | 留言人昵称 | 是 |
| content | string | 留言内容 | 是 |
| worksid | number | 作品id | 是 |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码 |
| message | string | 状态信息 |
简要描述
- 作者回复接口
请求URL
- /task3/reply
请求方式
- POST
请求参数
| 参数名 | 类型 | 说明 | 是否必选 |
|---|---|---|---|
| content | string | 回复内容 | 是 |
| message | number | 留言id | 是 |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码 |
| message | string | 状态信息 |
简要描述
- 查看简介接口
请求URL
- /task3/intro/{type}
请求方式
- GET
请求参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| type | number | 简介类型,0艺术家简介，1工作室简介，2成员简介 |
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码 |
| message | string | 状态信息 |
| data | object | 数据 |
data:
| 字段 | 类型 | 说明 |
|---|---|---|
| content | string | 简介内容 |
数据表
1.游客昵称表
2.一级作品集
3.二级作品集
4.作者
5.banner
6.简介表
7.留言表
8.留言回复表
9.工作室
10.作品表
明天计划的事情：
写接口
遇到的问题：
分析了很久写出来接口文档和数据表，还不知道对不对。
收获：
返回列表
评论