Cursor rule

1---
2description:
3globs:
4alwaysApply: false
5---
6# API 请求规范
7 
8## 1. 请求函数命名和结构
9```typescript
10// service/api/user.ts
11import { request } from '@/service/request';
12 
13// 获取用户列表
14export const fetchUserList = (params: UserListParams) => {
15  return request<UserListResponse>({
16    url: '/user/list',
17    method: 'GET',
18    params,
19  });
20};
21 
22// 获取用户详情
23export const fetchUserById = (id: string) => {
24  return request<UserInfo>({
25    url: `/user/${id}`,
26    method: 'GET',
27  });
28};
29 
30// 创建用户
31export const createUser = (data: CreateUserData) => {
32  return request<ApiResponse>({
33    url: '/user',
34    method: 'POST',
35    data,
36  });
37};
38 
39// 更新用户
40export const updateUser = (id: string, data: UpdateUserData) => {
41  return request<ApiResponse>({
42    url: `/user/${id}`,
43    method: 'PUT',
44    data,
45  });
46};
47 
48// 删除用户
49export const deleteUser = (id: string) => {
50  return request<ApiResponse>({
51    url: `/user/${id}`,
52    method: 'DELETE',
53  });
54};
55```
56 
57### 2. 类型定义规范
58```typescript
59// types/api.d.ts
60interface ApiResponse<T = any> {
61  code: number;
62  message: string;
63  data: T;
64}
65 
66interface UserInfo {
67  id: string;
68  name: string;
69  email: string;
70  role: string;
71  createTime: string;
72  updateTime: string;
73}
74 
75interface UserListParams {
76  page: number;
77  pageSize: number;
78  keyword?: string;
79  role?: string;
80}
81 
82interface UserListResponse {
83  list: UserInfo[];
84  total: number;
85}
86```
87 
88