接口
2026-02-27 17:26:08
15
接口
接口概述
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 | 站点不存在 | 跳转到站点不存在页面 |
加入我们
