From e1c59989790f052de89f8be85d4996bffeb71967 Mon Sep 17 00:00:00 2001 From: 8vd8 <“1936002261@qq.com”> Date: Wed, 7 May 2025 16:12:26 +0800 Subject: [PATCH] =?UTF-8?q?=E6=8F=90=E4=BA=A4=20readme?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 300 ++++++++++++++++++ unpackage/dist/dev/mp-weixin/common/vendor.js | 2 +- 2 files changed, 301 insertions(+), 1 deletion(-) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..506f3cf --- /dev/null +++ b/README.md @@ -0,0 +1,300 @@ +# Uni-Fans API 接口文档 + +本文档详细说明了 Uni-Fans 应用中使用的所有接口，包括参数说明和使用示例。 + +## 目录 + +1. [订单查询接口](#1-订单查询接口) +2. [设备信息查询接口](#2-设备信息查询接口) +3. [订单套餐更新接口](#3-订单套餐更新接口) +4. [用户余额更新接口](#4-用户余额更新接口) +5. [微信支付订单创建接口](#5-微信支付订单创建接口) +6. [设备租借指令接口](#6-设备租借指令接口) + +## 1. 订单查询接口 + +### 描述 +根据订单ID查询订单详细信息。 + +### 接口信息 +- **方法名**: `queryById` +- **请求方式**: GET +- **URL**: `/app/order/query/{orderId}` + +### 请求参数 + +| 参数名 | 类型 | 必须 | 描述 | +| ----- | ---- | ---- | ---- | +| orderId | String | 是 | 订单ID | + +### 响应参数 + +```json +{ + "code": 200, + "msg": "操作成功", + "data": { + "orderId": "订单ID", + "orderNo": "订单编号", + "deviceNo": "设备编号", + "createTime": "创建时间", + "phone": "联系电话", + "depositAmount": "押金金额", + "packageTime": "套餐时间(分钟)", + "packagePrice": "套餐价格" + } +} +``` + +### 使用示例 + +```javascript +const orderInfo = await queryById('12345'); +if (orderInfo.code === 200) { + // 处理订单信息 + console.log(orderInfo.data); +} +``` + +## 2. 设备信息查询接口 + +### 描述 +根据设备编号查询设备详细信息。 + +### 接口信息 +- **方法名**: `getDeviceInfo` +- **请求方式**: GET +- **URL**: `/app/device/info/{deviceNo}` + +### 请求参数 + +| 参数名 | 类型 | 必须 | 描述 | +| ----- | ---- | ---- | ---- | +| deviceNo | String | 是 | 设备编号 | + +### 响应参数 + +```json +{ + "code": 200, + "msg": "操作成功", + "data": { + "device": { + "deviceNo": "设备编号", + "deviceName": "设备名称", + "deviceStatus": "设备状态", + "depositAmount": "押金金额", + "feeType": "收费类型(hour/times)", + "feeConfig": "费用配置JSON字符串" + } + } +} +``` + +### 使用示例 + +```javascript +const deviceInfo = await getDeviceInfo('D001'); +if (deviceInfo.code === 200) { + // 处理设备信息 + console.log(deviceInfo.data.device); +} +``` + +## 3. 订单套餐更新接口 + +### 描述 +更新订单的套餐信息。 + +### 接口信息 +- **方法名**: `updateOrderPackage` +- **请求方式**: POST +- **URL**: `/app/order/update-package` + +### 请求参数 + +| 参数名 | 类型 | 必须 | 描述 | +| ----- | ---- | ---- | ---- | +| orderId | String | 是 | 订单ID | +| packageTime | Number | 是 | 套餐时间(分钟) | +| packagePrice | Number | 是 | 套餐价格 | + +### 响应参数 + +```json +{ + "code": 200, + "msg": "操作成功", + "data": null +} +``` + +### 使用示例 + +```javascript +const result = await updateOrderPackage({ + orderId: '12345', + packageTime: 360, // 6小时(分钟) + packagePrice: 30 // 30元 +}); +if (result.code === 200) { + console.log('套餐更新成功'); +} +``` + +## 4. 用户余额更新接口 + +### 描述 +支付成功后更新用户余额信息。 + +### 接口信息 +- **方法名**: `updateUserBalance` +- **请求方式**: POST +- **URL**: `/app/user/update-balance` + +### 请求参数 + +| 参数名 | 类型 | 必须 | 描述 | +| ----- | ---- | ---- | ---- | +| orderId | String | 是 | 订单ID | + +### 响应参数 + +```json +{ + "code": 200, + "msg": "操作成功", + "data": { + "userId": "用户ID", + "balance": "更新后余额" + } +} +``` + +### 使用示例 + +```javascript +const result = await updateUserBalance('12345'); +if (result.code === 200) { + console.log('用户余额更新成功'); +} +``` + +## 5. 微信支付订单创建接口 + +### 描述 +创建微信支付订单。 + +### 接口信息 +- **请求方式**: GET +- **URL**: `/app/wx-payment/create/{orderNo}` + +### 请求参数 + +| 参数名 | 类型 | 必须 | 描述 | +| ----- | ---- | ---- | ---- | +| orderNo | String | 是 | 订单编号 | + +### 请求头 + +| 参数名 | 必须 | 描述 | +| ----- | ---- | ---- | +| Authorization | 是 | Bearer 认证令牌 | +| Clientid | 是 | 客户端ID | + +### 响应参数 + +```json +{ + "code": 200, + "msg": "操作成功", + "data": { + "appId": "微信应用ID", + "timeStamp": "时间戳", + "nonceStr": "随机字符串", + "package": "预支付交易会话标识", + "signType": "签名类型", + "paySign": "签名" + } +} +``` + +### 使用示例 + +```javascript +const res = await uni.request({ + url: `${URL}/app/wx-payment/create/${orderNo}`, + method: 'GET', + header: { + 'Authorization': "Bearer " + uni.getStorageSync('token'), + 'Clientid': uni.getStorageSync('client_id') + } +}); + +if (res.statusCode === 200 && res.data.code === 200) { + const payParams = res.data.data; + await uni.requestPayment({ + ...payParams, + success: () => { + console.log('支付成功'); + }, + fail: (err) => { + console.error('支付失败:', err); + } + }); +} +``` + +## 6. 设备租借指令接口 + +### 描述 +发送设备租借指令。 + +### 接口信息 +- **请求方式**: POST +- **URL**: `/app/device/sendRentCommand` + +### 请求参数 + +| 参数名 | 类型 | 必须 | 描述 | +| ----- | ---- | ---- | ---- | +| orderId | String | 是 | 订单ID | + +### 请求头 + +| 参数名 | 必须 | 描述 | +| ----- | ---- | ---- | +| Content-Type | 是 | application/x-www-form-urlencoded | +| Authorization | 是 | Bearer 认证令牌 | +| Clientid | 是 | 客户端ID | + +### 响应参数 + +```json +{ + "code": 200, + "msg": "操作成功", + "data": null +} +``` + +### 使用示例 + +```javascript +const res = await uni.request({ + url: `${URL}/app/device/sendRentCommand`, + method: 'POST', + data: { + orderId: '12345' + }, + header: { + 'Content-Type': 'application/x-www-form-urlencoded', + 'Authorization': "Bearer " + uni.getStorageSync('token'), + 'Clientid': uni.getStorageSync('client_id') + } +}); + +if (res.statusCode === 200 && res.data.code === 200) { + console.log('租借指令发送成功'); +} +``` \ No newline at end of file diff --git a/unpackage/dist/dev/mp-weixin/common/vendor.js b/unpackage/dist/dev/mp-weixin/common/vendor.js index 1ff87c6..ee3b88b 100644 --- a/unpackage/dist/dev/mp-weixin/common/vendor.js +++ b/unpackage/dist/dev/mp-weixin/common/vendor.js @@ -6876,7 +6876,7 @@ function initOnError() { function initRuntimeSocketService() { const hosts = "127.0.0.1,192.168.10.9"; const port = "8090"; - const id = "mp-weixin_F5FmSr"; + const id = "mp-weixin_uN9NT1"; const lazy = typeof swan !== "undefined"; let restoreError = lazy ? () => { } : initOnError();