- 📖 序言
- 🚀 本地开发部署
- 🖥️ 服务器部署
- 📝 项目启动流程
- 📁 项目目录结构
- ☕ java 服务端
- 🎛️ 管理端前端
- 📱 手机端前端
- 🌐 web 端前端
- 🔧 代码生成器
- 🔌 API 接口
- 📦 插件开发
- ⚙️ 功能配置
接口
接口概述
uni-app 端接口系统基于 uni.request API 封装,提供统一的请求处理、错误处理和权限控制机制,支持 H5、小程序、App 等多端运行环境。所有接口通过 request.ts 工具类进行统一管理,确保接口调用的一致性和可维护性
API 请求配置
请求工具类封装
request.ts 是 uni-app 端的核心请求工具类,封装了请求拦截、响应处理、错误处理等功能。文件位置:uni-app/src/utils/request.ts
核心功能
-
请求拦截器:自动携带
token、site-id、app-channel等请求头信息 -
响应处理:统一处理响应数据,支持成功/错误消息提示
-
错误处理:统一处理网络错误、业务错误和认证错误
-
多端适配:支持 H5、小程序、App 等多端环境
-
文件上传:封装
uni.uploadFileAPI,支持图片、视频等文件上传
配置说明
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
baseUrl |
string | VITE_APP_BASE_URL |
接口基础地址,从环境变量获取 |
showErrorMessage |
boolean | true |
是否显示错误消息 |
showSuccessMessage |
boolean | false |
是否显示成功消息 |
错误处理
错误码说明
| 错误码 | 说明 | 处理方式 |
|---|---|---|
| 0 | 业务错误 | 显示错误消息提示 |
| 400 | 请求参数错误 | 显示错误消息提示 |
| 401 | 未授权/登录过期 | 跳转到登录页面 |
| 402 | 站点已关闭 | 跳转到站点关闭页面 |
| 403 | 站点不存在 | 跳转到站点不存在页面 |