接口
接口概述
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 | 站点不存在 | 跳转到站点不存在页面 |
