跳到正文

快速开始 ​

已有接口时,按下面的代码接入。想先验证一次真实请求,可以从零运行分页示例,按步骤创建 .NET API、配置 Vite 代理并接入 FastAxios。

应用启动时先创建全局 FastAxios 容器,再通过 axiosUtil.request() 发起请求:

此示例需要替换接口地址。先按安装说明添加依赖,在应用入口初始化一次。示例关闭请求加密,按项目需要再配置认证和处理器。

ts
import { axiosUtil, createFastAxios } from "@fast-china/axios";

createFastAxios({
	baseUrl: "https://api.example.com",
	requestCipher: false,
});

interface User {
	id: number;
	name: string;
}

const user = await axiosUtil.request<User>({
	url: "/users/1",
	method: "get",
	requestType: "query",
});

FastAxios 也提供 default 导出,公开入口和命名导入方式见包入口。

三种 JSON 响应结果 ​

如果 Fast.NET 返回以下响应,上面的 user 就是 { id: 1, name: "Alice" }。

json
{ "code": 200, "success": true, "message": "", "data": { "id": 1, "name": "Alice" } }
服务端响应单次请求选项返回值
Fast.NET 包装的 JSON默认data 中的用户对象,校验 code 和 success
Fast.NET 包装的 JSONsimpleDataFormat: false完整的 Fast 响应体,仍校验 code 和 success
普通 JSON { "id": 1, "name": "Alice" }restfulResult: false原始 JSON 响应体,跳过 Fast 业务校验和拆包

完整 Fast 响应体指 { code, success, message, data }。文件下载和非 JSON 响应的返回规则见请求选项。

下一步可按远程分页接入把请求接到 FaTable。