Web项目乐淘（LeTao）前后段对接的接口文档

• 说明：

1：说明注册成功

错误

---

| 格式 | 说明 |

| — | — |

| 接口名 | /error |

| 请求方式 | POST |

| 请求参数 | 无 |

| 返回 | 错误 |

• 说明:

除登录外，其他请求所有错误都会返回"错误"字样 前端可自由处理

用户模块

====================================================================

修改用户名

---

| 格式 | 说明 |

| — | — |

| 接口名 | /users |

| 请求方式 | PUT |

| 请求参数 | 类型 ：JSON |

| 属性 | uid pwd nickname phone area head_url |

| 含义 | 学号 密码 昵称 电话号码 校区 头像URL |

| 返回 | 1 |

• 说明:

1说明修改成功

获取用户信息

---

| 格式 | 说明 |

| — | — |

| 接口名 | /users/{uid} |

| 请求方式 | GET |

| 请求参数 | 类型：整数 |

| 属性 | uid |

| 含义 | 学号 |

| 返回 | JSON |

返回样例：

{

“uid”: 201901,

“pwd”: “123456”,

“nickname”: “john”,

“phone”: “123456789”,

“area”: “ruanjianyuan”,

“head_url”: “www.baidu.com”

}

• 字段说明

学号 密码 昵称 电话号码 校区 头像URL

订单模块

====================================================================

根据买家信息获取订单

---

| 格式 | 说明 |

| — | — |

| 接口名 | /orders/bid/{bid} |

| 请求方式 | GET |

| 请求参数 | 类型 ：整数 |

| 属性 | bid |

| 说明 | 买家学号 |

| 返回 | JSON |

URL:/orders/bid/{bid}

方式:GET

参数:

名称:bid

类型:int

说明:买家学号

返回样例:

{

“time”: “2018-08-02 22:05:52”,

“buyer”: {

“uid”: 201901,

“pwd”: null,

“nickname”: null,

“phone”: null,

“area”: null,

“head_url”: null

},

“seller”: {

“uid”: 201902,

“pwd”: null,

“nickname”: null,

“phone”: null,

“area”: null,

“head_url”: null

},

“goods”: {

“gid”: 101,

“gname”: null,

“description”: null,

“area”: null,

“price”: null,

“kind”: null,

“user”: null,

“time”: null,

“imgURLs”: null,

“comments”: null

}

}

• 字段说明

time是时间,buyer是买家,seller是卖家,goods是商品

根据卖家信息获取订单

---

| 格式 | 说明 |

| — | — |

| 接口名 | /orders/sid/{sid} |

| 请求方式 | GET |

| 请求参数 | 类型 ：整数 |

| 属性 | sid |

| 说明 | 卖家学号 |

| 返回 | JSON |

• 说明：

返回样例以及字段说明同上

提交订单

---

| 格式 | 说明 |

| — | — |

| 接口名 | /orders |

| 请求方式 | POST |

| 请求参数 | 类型 ：JSON |

| 属性 | time buyer_id seller_id gid |

| 含义 | 时间 买家ID 卖家ID 商品ID |

| 返回 | 1 |

• 备注：

time(格式: yyyy-mm-dd hh:mm:ss)

• 字段说明:1说明添加成功

商品模块

====================================================================

发布商品

---

| 格式 | 说明 |

| — | — |

| 接口名 | /goods |

| 请求方式 | POST |

| 请求参数 | 类型 ：JSON |

| 属性 | gname description area price kind time user imgURLs |

| 返回状态码 | 201 |

• 参数样例

{

“gname”: “联想电脑”,

“description”: “白色”,

“area”: “中心”,

“price”: 2000,

“kind”: “电子产品”,

“time”: “2020-12-2 23:31:20”,

“user”: {

“uid”: 1

},

“imgURLs”: [

“h10-1”,

“h10-2”,

“h10-3”

]

}

随机获取商品列表

---

| 格式 | 说明 |

| — | — |

| 接口名 | /goods |

| 请求方式 | GET |

| 请求参数 | 无 |

| 返回状态码 | 200 |

| 返回值 | JSON数组 |

• 返回值样例

[

{

“gid”: 6,

“gname”: “平板”,

“description”: “白色”,

“area”: “洪家楼”,

“price”: 20.0,

“kind”: “IPAD”,

“time”: “2020-12-02 23:31:20”,

“user”: null,

“imgURLs”: [],

“comments”: null

},

{

……

},

{

……

}

]

功能：

按时间顺序返回商品列表

---

| 格式 | 说明 |

| — | — |

| 接口名 | /goods-by-time |

| 请求方式 | GET |

| 请求参数 | 无 |

| 返回状态码 | 200 |

| 返回值 | JSON数组 |

返回值同上例。

搜索某个商品的详细信息

---

| 格式 | 说明 |

| — | — |

| 接口名 | /goods/{gid} |

| 请求方式 | GET |

| 请求参数 | gid |

| 类型 | 整数 |

| 含义 | 商品编号 |

| 返回状态码 | 200 |

| 返回值 | JSON对象 |

• 返回样例

{

“gid”: 1,

“gname”: “耳机”,

“description”: “红色”,

“area”: “兴隆山”,

“price”: 20.0,

“kind”: “Mac”,

“time”: “2008-08-08 00:00:00”,

“user”: {

“uid”: 1,

“pwd”: null,

“nickname”: “小花”,

“phone”: “15662679012”,

“area”: “软件园”,

“head_url”: “小花的头像”

},

“imgURLs”: [

“h11”,

“h12”,

“h13”

],

“comments”: [

{

“comment_id”: 2,

“gid”: null,

“user”: {

“uid”: 1,

“pwd”: null,

“nickname”: “小花”,

“phone”: “15662679012”,

“area”: “软件园”,

“head_url”: “小花的头像”

},

“text”: “谢谢”,

“time”: “2020-12-02 21:40:00”

},

{

……

},

{

……

},

……

]

}

查询某个用户发布的所有商品

---

| 格式 | 说明 |

| — | — |

| 接口名 | /goods-by-user/{uid} |

| 请求方式 | GET |

| 请求参数 | uid |

| 类型 | 整数 |

| 含义 | 学生学号 |

| 返回状态码 | 200 |

| 返回值 | JSON数组 |

• 返回样例:

[

{

“gid”: 3,

“gname”: “手机”,

“description”: null,

“area”: null,

“price”: 1000.0,

“kind”: null,

“time”: “2020-08-08 00:00:00”,

“user”: null,

“imgURLs”: [],

“comments”: null

},

{

……

},

……

]

根据商品的种类搜索商品

---

| 格式 | 说明 |

| — | — |

| 接口名 | /goods-by-kind/{kind} |

| 请求方式 | GET |

| 请求参数 | kind |

| 类型 | 字符串 |

| 含义 | 商品种类 |

| 返回状态码 | 200 |

| 返回值 | JSON数组 |

• 返回样例

[

{

“gid”: 4,

“gname”: “耳机”,

“description”: “蓝色”,

“area”: null,

“price”: 200.0,

“kind”: “华为”,

“time”: null,

“user”: null,

“imgURLs”: [],

“comments”: null

}，

{

},

……

]

按商品的名字模糊查询商品

---

| 格式 | 说明 |

| — | — |

| 接口名 | /goods-by-name/{name} |

| 请求方式 | GET |

| 请求参数 | name |

| 类型 | 字符串 |

| 含义 | 商品名字 |

| 返回状态码 | 200 |

| 返回值 | JSON数组 |

返回值类似上例。

评论模块

====================================================================

新增评论

---

| 格式 | 说明 |

| — | — |

| 接口名 | /comment |

| 请求方式 | POST |

| 请求参数 | 类型 ：JSON |

| 含义 | 一个评论的对象 |

| 返回状态码 | 201 |

• 请求参数样例

{

“gid”: 3,

“user”: {

“uid”: 2,

“pwd”: null,

“nickname”: “小明”,

“phone”: “15899881122”,

“area”: “中心校区”,

“head_url”: “小明的头像”

},

“text”: “不错，很想买！”,

“time”: “2019-09-09 00:00:00”

}

删除评论

---

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数前端工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Web前端开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上前端开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且后续会持续更新

如果你觉得这些内容对你有帮助，可以添加V获取：vip1024c （备注前端）

打开全栈工匠技能包-1小时轻松掌握SSR

两小时精通jq+bs插件开发

生产环境下如歌部署Node.js

网易内部VUE自定义插件库NPM集成

谁说前端不用懂安全，XSS跨站脚本的危害

webpack的loader到底是什么样的？两小时带你写一个自己loader

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

g)

生产环境下如歌部署Node.js

网易内部VUE自定义插件库NPM集成

谁说前端不用懂安全，XSS跨站脚本的危害

webpack的loader到底是什么样的？两小时带你写一个自己loader

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！
[外链图片转存中…(img-Shasz5YG-1712872772599)]