HomeLease/api

API 模块使用说明

概述

本项目使用统一的API请求工具 @/utils/request.js，所有API请求都通过该工具进行，无需重复配置基地址和请求头。

目录结构

api/
├── index.js          # API模块统一导出
├── lease/            # 租赁相关API
│   └── lease.js
├── device/           # 设备相关API
│   └── device.js
├── banner/           # 轮播图相关API
│   └── banner.js
├── article/          # 文章相关API
│   └── article.js
└── auth/             # 认证相关API
    └── auth.js

使用方法

1. 导入API方法

// 方式1：从具体模块导入
import { getDeviceTypes, getPeriodPackages } from '@/api/lease/lease.js'

// 方式2：从统一入口导入
import { getDeviceTypes, getPeriodPackages } from '@/api/index.js'

2. 在组件中使用

export default {
  methods: {
    async fetchData() {
      try {
        const response = await getDeviceTypes()
        
        if (response.code === 200) {
          this.deviceTypes = response.data
        } else {
          throw new Error(response.message || '请求失败')
        }
      } catch (error) {
        console.error('获取数据失败:', error)
        uni.showToast({
          title: error.message || '获取数据失败',
          icon: 'error',
        })
      }
    }
  }
}

API方法命名规范

• 获取列表：getXxxList
• 获取详情：getXxxDetail
• 创建：createXxx
• 更新：updateXxx
• 删除：deleteXxx

请求工具特性

自动处理

• ✅ 基地址配置
• ✅ 请求头设置
• ✅ Token管理
• ✅ Loading状态
• ✅ 错误处理
• ✅ 超时处理

配置选项

request({
  url: '/api/endpoint',
  method: 'GET',
  params: { id: 1 },
  loadingText: '加载中...',    // 自定义loading文本
  showLoading: true,          // 是否显示loading
  timeout: 60000,            // 超时时间
  noToken: false,            // 是否需要token
})

环境配置

请求工具会根据当前环境自动选择对应的配置：

• 开发环境：http://192.168.2.114:4601
• 体验版：http://192.168.2.114:4601
• 正式版：http://192.168.2.114:4601

错误处理

所有API请求都会自动处理以下错误：

• 401：登录过期，自动跳转登录页
• 403：权限不足
• 404：资源不存在
• 500：服务器错误
• 网络错误：超时、连接失败等

注意事项

1. 方法名冲突：避免页面方法名与API方法名相同，建议使用别名导入
2. Loading管理：请求工具已内置loading管理，无需手动处理
3. 错误提示：统一使用 uni.showToast 显示错误信息
4. Token处理：开发环境支持临时token，生产环境使用真实token