Skip to content

接口

接口概述

uni-app 端接口系统基于 uni.request API 封装,提供统一的请求处理、错误处理和权限控制机制,支持 H5、小程序、App 等多端运行环境。所有接口通过 request.ts 工具类进行统一管理,确保接口调用的一致性和可维护性

API 请求配置

请求工具类封装

request.ts 是 uni-app 端的核心请求工具类,封装了请求拦截、响应处理、错误处理等功能。文件位置:uni-app/src/utils/request.ts

核心功能

  • 请求拦截器:自动携带 tokensite-idapp-channel 等请求头信息

  • 响应处理:统一处理响应数据,支持成功/错误消息提示

  • 错误处理:统一处理网络错误、业务错误和认证错误

  • 多端适配:支持 H5、小程序、App 等多端环境

  • 文件上传:封装 uni.uploadFile API,支持图片、视频等文件上传

配置说明

配置项类型默认值说明
baseUrlstringVITE_APP_BASE_URL接口基础地址,从环境变量获取
showErrorMessagebooleantrue是否显示错误消息
showSuccessMessagebooleanfalse是否显示成功消息

错误处理

错误码说明

错误码说明处理方式
0业务错误显示错误消息提示
400请求参数错误显示错误消息提示
401未授权/登录过期跳转到登录页面
402站点已关闭跳转到站点关闭页面
403站点不存在跳转到站点不存在页面

基于 MIT 协议发布