request 网络请求

简述

基于 uni.request 封装的网络请求工具（见 uni_modules/m-unix/components/m-tools/Request.uts），支持链式 http.get / http.post 等与统一响应结构。

注意

请以 uni_modules/m-unix 与本文为准；各端差异以 uni-app 与各平台官方文档为准。涉及隐私能力（相册、定位、剪贴板、手机号等）需在 manifest 与后台完成配置。

平台差异说明

App（vue）	App（nvue）	H5	小程序
√	√	√	√

演示地址

类型	说明
线上 H5	无独立分包演示页（文档站 iframe 已关闭 preview: false）
参考	见下方「基本使用」与 uni_modules/m-unix 源码

基本使用

import { http } from '@/uni_modules/m-unix'
import { config } from '@/common/config'

// GET 请求
const getList = async () => {
	const res = await http.get(config.api.somePath, { page: 1 })
	return res.data
}

// POST 请求
const createData = async (data: UTSJSONObject) => {
	const res = await http.post('/api/create', data as UTSJSONObject)
	return res.data
}

配置说明

业务项目的 baseUrl、timeout 等通常在 common/config 与 Request.uts 依赖的 config 中维护；安装示例见 安装与配置教程。

API（节选）

实际导出以 Request.uts 为准，常见用法包括：

能力	说明
http.get / http.post / http.put / http.delete	快捷请求
http.public / http.silent / http.loading	无需登录、静默、带 loading 等场景
http.upload	文件上传（内部走 Upload.uts）

返回格式

与 Request.uts 中 ApiResponse 约定一致，常见字段：

{
	"code": 0,
	"msg": "success",
	"data": {}
}

错误处理

• 网络错误可按 Request.uts 默认行为提示
• 业务错误根据 code 处理；未授权等场景可配置跳转登录页路径