【e修租赁-骑手端】接口文档 V1.0.0.docx

1. 简介 1.1. 目的 是统一为e修租赁,Html5,IOS,安卓端提供对外接口开放的标准，可为项目其调用提供依据。 1.2. 范围 适用于建设e修租赁的各个客户端的开发工程师，测试工程师，系统分析师。 1.3. 约定 使用Json，post传值的方式来进行传递。所有枚举类型请参考最后的附录. 1.4. 接口调用方式 2. 接口需求 ### 知识点生成 #### 一、接口文档概述 **文档目的：** 该文档的主要目的是为e修租赁项目的HTML5、iOS与Android客户端提供一套标准化的对外接口规范。这有助于确保不同平台间的开发人员能够遵循一致的标准进行开发工作，从而提高系统的兼容性和维护性。 **适用范围：** 该文档适用于所有参与e修租赁项目的开发人员，包括前端开发者、后端开发者、测试工程师以及系统分析师等。通过明确接口的具体实现细节，可以减少开发过程中的沟通成本，提升整体项目效率。 **约定：** - **数据格式**：接口之间通信的数据格式采用JSON。 - **请求方法**：所有的接口请求都采用POST方法。 - **枚举类型**：文档末尾提供了所有枚举类型的定义，以便开发者在实现过程中正确使用这些类型。 **接口调用方式：** - 所有接口均通过HTTP协议进行调用，并且使用POST方法传递参数。 #### 二、接口需求 **1. 骑手维修模块** **1.1 [210001] 获取维修站列表** - **功能描述**：此接口用于获取当前位置附近的维修站列表。 - **请求URL**：`http://xxxxxx:2004/api/RepairStationInfo/FRepairStationInfoGetListByLatLng` - **请求参数**： - `Longitude`: 经度（double类型，必填） - `Latitude`: 纬度（double类型，必填） **1.2 [210002] 获取维修站详情** - **功能描述**：通过提供维修站ID来获取详细的维修站信息。 - **请求URL**：待补充 - **请求参数**：待补充 **1.3 [210003] 获取区域上门费** - **功能描述**：根据当前位置获取上门服务费用。 - **请求URL**：待补充 - **请求参数**：待补充 **1.4 [210004] 创建维修工单** - **功能描述**：创建一个新的维修请求。 - **请求URL**：待补充 - **请求参数**：待补充 **1.5 [210005] 获取维修订单总数** - **功能描述**：查询当前维修工单的总数。 - **请求URL**：待补充 - **请求参数**：待补充 **1.6 [210006] 根据类型获取订单列表** - **功能描述**：根据不同的筛选条件获取维修订单列表。 - **请求URL**：待补充 - **请求参数**：待补充 **1.7 [210007] 上门费支付前验证** - **功能描述**：验证上门费支付是否满足条件。 - **请求URL**：待补充 - **请求参数**：待补充 **1.8 [210008] 订单详情** - **功能描述**：获取指定维修订单的详细信息。 - **请求URL**：待补充 - **请求参数**：待补充 **1.9 [210009] 订单开始维修** - **功能描述**：标记维修订单状态为“开始维修”。 - **请求URL**：待补充 - **请求参数**：待补充 **1.10 [210010] 订单支付后回调** - **功能描述**：支付成功后的回调接口，通知系统更新订单状态。 - **请求URL**：待补充 - **请求参数**：待补充 **1.11 [210011] 骑手认证接口** - **功能描述**：用于骑手的身份认证。 - **请求URL**：待补充 - **请求参数**：待补充 **2. 骑手新增功能** **2.1 [220001] 注册接口** - **功能描述**：用于新骑手的注册操作。 - **请求URL**：待补充 - **请求参数**：待补充 **2.2 [220002] 获取优惠券列表接口** - **功能描述**：查询可用的优惠券列表。 - **请求URL**：待补充 - **请求参数**：待补充 **2.3 [220003] 月租支付、订单购买支付前认证** - **功能描述**：在进行支付前对骑手进行身份验证。 - **请求URL**：待补充 - **请求参数**：待补充 **2.4 [220004] 维修费支付前验证** - **功能描述**：验证维修费用支付前的信息。 - **请求URL**：待补充 - **请求参数**：待补充 **2.5 [220005] 获取已经邀请的用户列表** - **功能描述**：查询由当前骑手邀请的所有用户列表。 - **请求URL**：待补充 - **请求参数**：待补充 **2.6 [220006] 获取租/购订单详情** - **功能描述**：获取租赁或购买订单的详细信息。 - **请求URL**：待补充 - **请求参数**：待补充 **2.7 [220006] 获取维修订单详情** - **功能描述**：获取维修订单的详细信息。 - **请求URL**：待补充 - **请求参数**：待补充 #### 三、附录 **DalEnum** 文档末尾还提到了一个DalEnum的概念，这可能是一个内部定义的枚举类型集合，用于描述某些业务逻辑的状态或分类。例如，可能包含了各种订单状态的定义、支付方式的定义等等。 **订单优惠逻辑** 文档还描述了一个订单优惠逻辑，包括了六个步骤： 1. 全场特价计算（如睡前抢、商品打折）； 2. 计算全场订单活动（如满额包邮）； 3. 计算会员折扣（如铜级会员享受折扣）； 4. 使用优惠券； 5. 积分抵扣； 6. 最终得出需支付的金额。 以上逻辑为订单处理过程中的价格计算提供了一套标准流程，有助于确保所有订单都能按照相同的规则进行处理，从而避免了因逻辑差异导致的问题。 #### 四、结语 通过这份接口文档，我们可以看到e修租赁项目的接口设计非常全面，涵盖了骑手端从获取维修站列表到订单管理的各个方面。对于开发人员来说，这份文档是非常有价值的资源，因为它不仅提供了清晰的接口规范，而且还包含了一些具体的业务逻辑描述，有助于理解整个系统的运作机制。