Web项目乐淘（LeTao）前后段对接的接口文档，金九银十正确打开方式

结尾

学习html5、css、javascript这些基础知识，学习的渠道很多，就不多说了，例如，一些其他的优秀博客。但是本人觉得看书也很必要，可以节省很多时间，常见的javascript的书，例如：javascript的高级程序设计，是每位前端工程师必不可少的一本书，边看边用，了解js的一些基本知识，基本上很全面了，如果有时间可以读一些，js性能相关的书籍，以及设计者模式，在实践中都会用的到。

开源分享：docs.qq.com/doc/DSmRnRG…

• 随机获取商品列表

• 按时间顺序返回商品列表

• 搜索某个商品的详细信息

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

• 根据商品的种类搜索商品

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

• 评论模块

• • 新增评论

• 删除评论

• 购物车模块

• • 添加商品到购物车

• 从购物车删除某件商品

• 查询某个用户的购物车的信息

• 上传模块

• • 上传用户头像

• 上传商品的图片

端口号

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

8888

登录、注册模块

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

登录

---

| 格式 | 说明 |

| --- | --- |

| 接口名 | /login |

| 请求方式 | POST |

| 请求参数 | 类型 ：JSON |

| 属性 | uid,pwd |

| 含义 | 用户学号、登录密码 |

| 返回 | 登录成功、登录失败 |

注册

---

| 格式 | 说明 |

| --- | --- |

| 接口名 | /users |

| 请求方式 | POST |

| 请求参数 | 类型 ：JSON |

| 属性 | uid pwd nickname phone area head_url |

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

| 返回 | 1 |

• 说明：

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

}，

{

},

……

]

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

---

分享

开源分享：【大厂前端面试题解析+核心总结学习笔记+真实项目实战+最新讲解视频】