企业官网建设流程全解析

1. 启动 Web API，确认浏览器能打开：

   http://localhost:5080/swagger/v1/swagger.json

   
   
   

2. 打开 Apifox，进入已有项目或新建一个 HTTP 项目。
   
   

3. 进入项目设置 → 导入数据，选择OpenAPI/Swagger。
   

4. 选择URL 导入，填写：

   http://localhost:5080/swagger/v1/swagger.json

5. 点击读取或继续，勾选全部接口，确认导入。重复导入时选择更新已有接口，避免重复创建。
   
   
   

6. 点击查看接口，在 Apifox 的环境管理中设置服务地址：

   环境	服务地址
   本地开发	http://localhost:5080
   正式环境	https://实际域名

   
   
   

   点击底部管理环境。
   
   

   选择开发环境，将模块的**服务地址（前置 URL）**设置为：

   http://localhost:5080

   点击保存并关闭。然后打开GET /health，选择开发环境、鉴权设为无需鉴权，点击发送。
   
   
   
   

   实际请求地址应为：

   http://localhost:5080/health

7. 调用/api/token/test获取 JWT，再为受保护接口设置Bearer Token。
   
   为了不用逐个手动添加Token。可以让登录接口自动保存 Token，其余接口统一引用。在当前/api/token/test的后置操作 → 自定义脚本中填写：

if (pm.response.code === 200) { let token; try { token = pm.response.json(); } catch { token = pm.response.text().trim(); } if (typeof token === "string" && token.length > 0) { pm.environment.set("token", token); } }

脚本正确，单击发送，登录已返回200。可以在管理环境 → 测试环境查看变量token的本地值，确认已保存。

配置正确，Token 已自动保存到测试环境的本地变量，远程值可以留空。

点击保存并关闭，然后打开/api/dept：​​​​​​​

直接单击发送出现401，直接原因是变量名不一致：登录脚本保存的是token，当前鉴权引用的是{{bearerToken}}。

将父级鉴权的 Token 改为：

{{token}}

也可以在当前接口将 Auth 改为Bearer Token，填写{{token}}。不要额外添加Bearer前缀。

然后在 Params 添加deptId=1，重新发送。建议修改父级鉴权，让所有继承它的接口一起生效。

选择下方自行设置 → Bearer Token，在 Token 输入框填写：

{{token}}

保存后重新发送请求。不要加Bearer前缀，Apifox 会自动添加。

选择读取变量 → 环境变量 →token，确认插入。

也可以关闭弹窗，直接在 Token 输入框填写：

{{token}}

保持右上角选择测试环境，点击保存后重新发送。若仍返回401，查看底部实际请求，确认请求头是：

Authorization: Bearer eyJ...

不要发送完整 Token，只需确认变量是否已替换成 JWT。

如果 URL 导入失败，浏览器打开上面的 JSON 地址，将文件下载到本机，然后在同一导入页面选择“文件导入”即可。


拓展：

也可从浏览器开发者工具（F12）中一键导入到ApiFox中，这种操作叫请求导出与导入，用于接口调试和请求重放。

具体是：浏览器抓取请求 → 导出为 cURL → 导入 Apifox → 重放请求。

它复制的是一次 HTTP 请求，不包含对方后端代码或接口实现。

例如：api.ashx这个接口。

直接把这条成功请求复制为 cURL，再导入 Apifox，接口、参数和请求头会一起带过去。

1. 在浏览器 Network 列表里，右键点击这条返回code=0的api.ashx。
2. 选择复制 → 复制为 cURL（bash）。
3. 打开 Apifox，选择导入 → cURL。不同版本也可能在新建接口旁提供“导入 cURL”。
4. 粘贴内容，确认导入，然后立即发送。