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

已于 2024-04-29 22:03:09 修改
阅读量779 收藏 19
点赞数 20
分类专栏： 程序员 文章标签： 前端
于 2024-04-29 22:03:08 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2401_84447207/article/details/138327157
版权

| 请求参数 | 类型 ：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 |

| 类型 | 字符串 |

最后

除了简历做到位，面试题也必不可少，整理了些题目，前面有117道汇总的面试到的题目，后面包括了HTML、CSS、JS、ES6、vue、微信小程序、项目类问题、笔试编程类题等专题。

2401_84447207
关注
  • 20
    点赞
  • 踩
  • 19
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
letao-windows:乐淘web app项目
05-13
乐淘电商移动端Mui介绍bootstrap 也是一个ui框架 响应式的ui框架 兼容不同终端 可以适配pc端 也可以适配 移动端Mui 是一个ui框架 针对移动端开发的ui框架 只能适配移动端（流式布局）学习官网官方文档组件展示特点最...
Web项目乐淘（LeTao）前后段对接的接口文档
SongyangJi
12-03 808
文章目录端口号登录、注册模块登录注册错误用户模块修改用户名获取用户信息订单模块根据买家信息获取订单根据卖家信息获取订单提交订单商品模块发布商品随机获取商品列表按时间顺序返回商品列表搜索某个商品的详细信息查询某个用户发布的所有商品根据商品的种类搜索商品按商品的名字模糊查询商品评论模块新增评论删除评论购物车模块添加商品到购物车从购物车删除某件商品查询某个用户的购物车的信息上传模块上传用户头像上传商品的图片 端口号 8888 登录、注册模块 登录 格式 说明 接口名 /login 请求方式 P
Web前端开发中的接口文档类型与要素解析
qq_44061998的博客
06-19 1724
接口文档在Web前端开发中起着至关重要的作用，本文将介绍常见的接口文档类型和接口要素，帮助前端开发人员更好地理解和处理接口文档，并提供相应的代码案例。
Web接口文档
HUBTOO的博客
04-23 214
接收词汇片段参数，加载词库，查询以该词汇片段开头的词汇，结果只返回前20个词汇，若未查询到词汇则返回空列表。若加载词库出错则返回“异常输出”。接收词汇，加载词库，查询该词汇的词性和中文释义，若未通过“参数检查”，加载词库出错或未查询到该词汇则返回“异常输出”。
小白开发微信小程序20--web api文档制作
hqwest的专栏
03-20 1135
SwaggerSwagger 项目已于 2015 年捐赠给 OpenAPI 计划，自此它被称为 OpenAPI。这两个名称可互换使用。不过，“OpenAPI”指的是规范。“Swagger”指的是来自使用 OpenAPI 规范的 SmartBear 的开放源代码和商业产品系列。简而言之：OpenAPI 是一种规范。Swagger 是一种使用 OpenAPI 规范的工具。例如，OpenAPIGenerator 和 SwaggerUIOpenAPI 规范是描述 API 功能的文档。
Swagger介绍及使用
光脚丫思考的专栏
09-25 2万+
作者：wuqke 链接：https://www.jianshu.com/p/349e130e40d5 来源：简书 著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。 一、导语 相信无论是前端还是后端开发，都或多或少地被接口文档折磨过。前端经常抱怨后端给的接口文档与实际情况不一致。后端又觉得编写及维护接口文档会耗费不少精力，经常来不及更新。其实无论是前端调用后端，还是后端调用后端，都期望有一个好的接口文档。但是这个接口文档对于程序员来说，就跟注释一样，经常会抱怨别人写的代码没有写注.
乐淘电商项目-letao.zip
最新发布
01-30
乐淘电商项目是一个典型的在线购物平台的实现，其核心目标是提供一个用户友好的界面，方便用户浏览商品、购买及管理订单。在这个项目中，“letao.zip”包含了整个项目的源代码，而“letao-master”可能代表了项目的...
乐淘电商项目-letao_my.zip
01-30
乐淘电商项目是一个典型的在线购物平台的实现，旨在提供一个完整的电子商务...以上是“乐淘电商项目-letao_my”可能涉及的主要技术栈和功能模块。通过深入研究这个项目，开发者可以提升在电商系统开发方面的综合能力。
letao:一个乐淘小项目
05-14
乐淘电商 移动端 Mui介绍 bootstrap 也是一个ui框架 响应式的ui框架 兼容不同终端 可以适配pc端 也可以适配 移动端 Mui 是一个ui框架 针对移动端开发的ui框架 只能适配移动端（流式布局） 学习官网 官方文档 组件...
letao888888:正式乐淘项目
03-23
乐淘电商移动端梅介绍bootstrap也是一个ui框架响应式的ui框架兼容不同终端可以适配pc端也可以适应移动端Mui是一个ui框架针对移动端开发的ui框架学习官网官方文档组件展示特色最接近原生APP体验的高级前端框架轻量...
乐淘电商网站
04-21
具体到页面功能： 1.顶部通栏 2.轮播图 3.导航栏 4.运动生活专区 5.底部页签 - 静态页面 - 搜索表单 包含了搜索框和按钮 - 历史搜索 两种情况 没有历史记录的情况 显示没有搜索历史记录 有历史记录的情况 显示 历史记录 清空操作 历史列表 - 动态渲染 - 输入搜索关键字 点击搜索 跳转搜索列表页 （把关键字传递给搜索列表页 同时记录这一次的搜索记录） - 需要页面初始化的时候 渲染上一次的搜索记录 （获取本地存储的数据 转换成js可以使用的数据 进行渲染） - 点击搜索记录对应的删除按钮 删除当前对应的历史记录 （获取本机的记录删除一条从新记录到本地存储当中） - 点击情况历史记录 情况所有记录 （把本来存储的数据清空） 需求 记录10数据 如果超过加一条 删一条 如果有一样的删除 记录新的
letao:这是我个人做的乐淘项目开源代码
03-23
<<<<<<< HEAD 乐淘电商 移动端 梅介绍 bootstrap也是一个ui框架响应式的ui框架兼容不同终端可以适配pc端也可以适应移动端 Mui是一个ui框架针对移动端开发的ui框架 学习官网 官方文档 组件展示 特色 最接近原生APP体验的高级前端框架 轻量追求性能体验，是我们开始启动MUI项目的首要目标，轻量必然是重要特征； MUI不依赖任何第三方JS库，压缩后的JS和CSS文件仅有100 + K和60 + K 原生UI针对之前的很多前端框架（特别是响应式布局的框架），UI控件看起来太像网页，没有原生感觉，因此追求原生UI感觉也是我们的重要目标MUI以iOS平台UI为基础，补充部分Android平台特有的UI控件 流畅体验拖放刷新为实现滚动刷新功能，主要是H5框架都是通过DIV模拟拖动回弹动画，在低端android手机上，DIV动画经常出现卡顿现象（特别是图文列表的情况）； m
letao18:乐淘项目18期
03-23
乐淘电商 移动端 梅介绍 bootstrap也是一个ui框架响应式的ui框架兼容不同终端可以适配pc端也可以适应移动端 Mui是一个ui框架针对移动端开发的ui框架 学习官网 官方文档 组件展示 特色 最接近原生APP体验的高级前端框架 轻量追求性能体验，是我们开始启动MUI项目的首要目标，轻量必然是重要特征； MUI不依赖任何第三方JS库，压缩后的JS和CSS文件仅有100 + K和60 + K 原生UI针对之前的很多前端框架（特别是响应式布局的框架），UI控件看起来太像网页，没有原生感觉，因此追求原生UI感觉也是我们的重要目标MUI以iOS平台UI为基础，补充部分Android平台特有的UI控件 流畅体验拖放刷新为实现滚动刷新功能，主要是H5框架都是通过DIV模拟拖动回弹动画，在低端android手机上，DIV动画经常出现卡顿现象（特别是图文列表的情况）； mui通过双webview解
乐淘前后台项目
08-13
乐淘前后台项目
黑马程序员__移动商城项目实战
12-21
黑马程序员__移动商城项目实战 包括黑马程序员乐淘商城实战和慕课React+Antd
怎么获取网页上的接口--并使用
你只有踏出第一步，下一步才会跟着来，否则你将永远停留在原地。
11-18 1万+
在这里插入图片描述 关于代码方面，这个是用springboot 的方法来的 @Autowired private Environment environment; //首先注入这个环境 String name = environment.getProperty("username1");//用这个代码获取属性 拼接所用接口字符串的方法 /拼接url接口地址调用 //首先实例化一个字符缓冲区 StringBuffer stringBuffer = new StringBuffer(); ..
Web前端开发之前后端交互03——接口测试、接口文档
DRLDER的博客
04-05 819
接口测试： 在我们使用POST和GET方法请求数据时，常常不知道页面接口是否有效或无法调试，下面借助POSTMAN工具可以很好的解决这一问题。 get方法测试： post方法测试： 接口文档： 示例： ...
前端接口文档范例
热门推荐
res_min的博客
05-11 4万+
公司主页接口信息按模块划分的接口1. 获取公司主页：顶部信息1.1 method: GET1.2 path: /api/homeTop-messages/:companyId1.3 options:1.4 response:type: jsonexample:{ id : 32967, name : '今日头条', img : 'http://oc3brgiv8.
接口&接口文档
MrNoboday
09-02 2万+
一、接口简介 API（Application Programming Interface）即应用程序接口，可以任务是一个软件组件或一个Web服务与外界进行交互的接口，在这里接口可以和API划等号。 接口可以简单的理解为一个黑盒子，从一边输入参数，另外一遍输出参数，黑盒子中的逻辑控制输入输出。 在web后端开发中，接口接受前端（browser、app、client）传入的数据，处理之后...
pyinstaller 误杀
01-15
pyinstaller是一个用于将Python程序打包成可执行文件的工具。它可以将Python代码和依赖的库打包成一个独立的可执行文件，方便在没有Python环境的机器上运行。然而，由于某些杀毒软件的误报机制，可能会将pyinstaller生成的可执行文件误判为病毒或恶意软件。 这种误报主要是因为pyinstaller的打包方式和一些病毒的打包方式相似，导致杀毒软件误判。为了避免这种误报，你可以采取以下几种方法： 1. 将pyinstaller生成的可执行文件添加到杀毒软件的白名单中，以免被误报。 2. 使用其他的打包工具，如cx_Freeze、py2exe等，尝试是否会有误报问题。 3. 将pyinstaller生成的可执行文件提交给杀毒软件厂商进行分析，以便他们更新病毒库，避免误报。 需要注意的是，虽然pyinstaller生成的可执行文件可能会被杀毒软件误报，但这并不意味着它本身是有害的。只要你从官方网站下载的pyinstaller，并且没有对其进行修改，一般情况下是安全的。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值