112 lines
3.2 KiB
Markdown
112 lines
3.2 KiB
Markdown
|
# Shop API 移植说明
|
|||
|
|
|
|||
|
|
## 移植概述
|
|||
|
|
将 `doc/code/shop` 目录下的 API 移植到 `src/api/shop` 目录下，并适配本项目的 HTTP 请求方式。
|
|||
|
|
|
|||
|
|
## 目录结构
|
|||
|
|
|
|||
|
|
### 移植前 (`doc/code/shop/`)
|
|||
|
|
```
|
|||
|
|
doc/code/shop/
|
|||
|
|
├── type.ts # 类型定义
|
|||
|
|
└── index.ts # API 函数
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 移植后 (`src/api/shop/`)
|
|||
|
|
```
|
|||
|
|
src/api/shop/
|
|||
|
|
├── types.ts # 类型定义（从 type.ts 移植）
|
|||
|
|
├── index.ts # API 函数（适配后）
|
|||
|
|
└── README.md # 使用说明文档
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 关键变更对比
|
|||
|
|
|
|||
|
|
### 1. 导入语句变更
|
|||
|
|
|
|||
|
|
**移植前:**
|
|||
|
|
```typescript
|
|||
|
|
import { request } from "@/http/axios"
|
|||
|
|
import { GetBalanceResponse, ... } from './type'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**移植后:**
|
|||
|
|
```typescript
|
|||
|
|
import { http } from "@/http/http";
|
|||
|
|
import type { ApiResult } from '@/api';
|
|||
|
|
import type {
|
|||
|
|
GetBalanceResponse,
|
|||
|
|
...
|
|||
|
|
} from './types';
|
|||
|
|
import { GetOpenIdRequestParams } from './types';
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. API 函数变更
|
|||
|
|
|
|||
|
|
**移植前:**
|
|||
|
|
```typescript
|
|||
|
|
export function getShopGoodsListApi(corpid: string, belongType: number) {
|
|||
|
|
return request<ApiResponseData<SearchGoodsDO[]>>({
|
|||
|
|
url: "shop/goods/list",
|
|||
|
|
method: "get",
|
|||
|
|
params: { corpid, belongType }
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**移植后:**
|
|||
|
|
```typescript
|
|||
|
|
export async function getShopGoodsListApi(corpid: string, belongType: number) {
|
|||
|
|
const res: any = await http.get<ApiResult<SearchGoodsDO[]>>("shop/goods/list", { corpid, belongType });
|
|||
|
|
if (res.data.state === 'ok') {
|
|||
|
|
return res.data.data;
|
|||
|
|
}
|
|||
|
|
return Promise.reject(new Error(res.data.message));
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 主要变更点
|
|||
|
|
|
|||
|
|
| 变更项 | 移植前 | 移植后 |
|
|||
|
|
|--------|--------|--------|
|
|||
|
|
| HTTP 请求库 | `@/http/axios` | `@/http/http` |
|
|||
|
|
| 请求方法 | `request({ url, method, params/data })` | `http.get()` / `http.post()` |
|
|||
|
|
| 泛型类型 | `ApiResponseData<T>` | `ApiResult<T>` |
|
|||
|
|
| 函数声明 | `function` | `async function` |
|
|||
|
|
| 返回处理 | 直接返回 Promise | 增加状态判断和错误处理 |
|
|||
|
|
| 类型导入 | 命名导入 | 类型专用导入 (`type` 关键字) |
|
|||
|
|
|
|||
|
|
## 移植的 API 函数列表
|
|||
|
|
|
|||
|
|
✅ 已完成移植的 API：
|
|||
|
|
1. `getShopGoodsListApi` - 获取商品列表
|
|||
|
|
2. `getShopGoodsApi` - 获取商品详情
|
|||
|
|
3. `submitOrderApi` - 提交订单
|
|||
|
|
4. `getOpenIdApi` - 获取微信 openid
|
|||
|
|
5. `qyLogin` - 企业微信登录
|
|||
|
|
6. `fakeQyLoginApi` - 模拟企业微信登录
|
|||
|
|
7. `getOrdersByOpenIdApi` - 根据 openid 获取订单
|
|||
|
|
8. `getOrdersByQyUserIdApi` - 根据企业微信用户ID获取订单
|
|||
|
|
9. `openCabinetApi` - 打开储物柜
|
|||
|
|
10. `getBalanceApi` - 获取用户余额（openid）
|
|||
|
|
11. `getBalanceByQyUserid` - 获取用户余额（userid）
|
|||
|
|
12. `getShopListApi` - 获取商店列表
|
|||
|
|
|
|||
|
|
## 使用方式
|
|||
|
|
|
|||
|
|
所有 API 函数现在都是 `async` 函数，返回值为实际数据（成功后）或 `Promise.reject`（失败后）。
|
|||
|
|
|
|||
|
|
**调用示例:**
|
|||
|
|
```typescript
|
|||
|
|
import { getShopGoodsListApi } from '@/api/shop';
|
|||
|
|
|
|||
|
|
// 在 async 函数中调用
|
|||
|
|
const goods = await getShopGoodsListApi('corpid', 0);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
1. 所有 API 函数现在返回实际数据，而不是包装后的响应对象
|
|||
|
|
2. 需要自行处理错误（使用 try-catch 或 .catch()）
|
|||
|
|
3. 类型定义文件 `types.ts` 包含了所有必要的类型
|
|||
|
|
4. 如需了解更多用法，请参考 `README.md`
|