快速开始
已有接口时,按下面的代码接入。想先验证一次真实请求,可以从零运行分页示例,按步骤创建 .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 包装的 JSON | simpleDataFormat: false | 完整的 Fast 响应体,仍校验 code 和 success |
普通 JSON { "id": 1, "name": "Alice" } | restfulResult: false | 原始 JSON 响应体,跳过 Fast 业务校验和拆包 |
完整 Fast 响应体指 { code, success, message, data }。文件下载和非 JSON 响应的返回规则见请求选项。
下一步可按远程分页接入把请求接到 FaTable。
