二手淘金网接口文档:用户、商品与订单操作

需积分: 0 0 下载量 66 浏览量 更新于2024-08-04 收藏 247KB DOCX 举报
"该文档是二手淘金网的接口说明3.0版,涵盖了会员功能、商品管理和订单管理三大模块,详细定义了各个接口的输入输出参数及功能。" 二手淘金网接口说明文档详细介绍了网站的核心功能,包括用户注册、登录、个人信息管理,以及商品的发布、修改、查询与订单处理等环节。以下是对这些知识点的详细说明: 1. **会员功能** - **注册**:用户需要提供用户名、手机号、密码、图片验证码、email和身份证进行注册,服务器返回响应码作为操作结果。 - **登录**:用户输入用户名、密码和用户类型(用户/管理员),登录成功后,服务器会将Token保存到session,并返回响应码。 - **退出**:清除浏览器中的用户账号session,实现用户安全退出。 - **修改个人信息**:允许用户修改User表中所有字段的信息,返回响应码作为操作结果。 - **修改密码**:用户需提供id、原始密码和新密码,服务器返回响应码。 2. **商品管理模块** - **商品/需求发布**:用户可发布商品或需求,需要提供标题、主图片、交易地点、物品类别、价格、详情描述、详细图片、联系方式、联系人和数量,服务器返回响应码。 - **商品/需求修改**:用户可以修改已发布的信息,需要商品id和6项基本信息,返回响应码。 - **取消发布**:通过商品id,用户可撤销发布,服务器返回响应码。 - **商品查询**:根据不同的审核状态(已通过、审核中、未通过),返回用户发布商品的概要信息。 - **商品分类查询**:根据类别id和供需类别查询所有人的商品信息。 - **商品详细信息**:通过商品id和类别状态获取详细信息。 - **按关键字查询**:用户输入商品名字,返回相关商品的概要信息列表。 3. **订单管理模块** - **用户下订单**:用户下单时需提供用户id、联系方式、商品id、卖家id、单价、数量、总价、备注和买家联系方式,服务器返回响应码和订单id。 - **商家确认**:商家对订单进行确认,可能涉及到后续的订单处理接口,但具体细节未给出。 此外,商品浏览统计功能会在每次商品被查询时自动增加浏览次数,这一功能通过独立的接口实现,返回响应码。 这些接口定义构成了二手淘金网的后台服务基础,支持用户与商品之间的交互,确保了平台的正常运行和数据交换的准确性。