Apifox 7 月更新｜通过 AI 命名参数及检测接口规范、在线文档支持自定义 CSS 和 JavaScript、鉴权能力升级

Apifox 新版本上线啦！

看看本次版本更新主要涵盖的重点内容，有没有你所关注的功能特性：

• AI 助力接口设计

  • 通过 AI 为参数命名

  • 支持让 AI 对接口进行规范性检测

• 在线文档功能增强

  • 在线文档支持自定义 CSS 和 JavaScript

  • 目录支持设置展示「数据模型」

  • 支持 Webhook 和 Callback 类型的接口

• 模块支持「模块变量」

• 鉴权能力升级

  • 「文档模式」下支持使用默认鉴权凭证

  • OAuth 2.0 鉴权交互优化

  • 当导入的接口设置了 Security 时，可将 Auth 设置为对应的鉴权组件

• 新增「离线空间」功能

• 用户反馈优化

  • 支持连接启用了 SSL 的 MySQL、PostgreSQL 数据库

  • 在查询、创建 MongoDB 文档时，支持 Date 等 BSON 数据类型

  • 用于生成业务代码的 OpenAPI Generator 升级至 v7.13.0

  • 解决调试 Socket.IO 接口时，如果接口返回了空的消息或 ack，界面报错的问题

将 Apifox 更新至最新版，一起开启全新体验吧！

 下载 Apifox 最新版

AI 助力接口设计

通过 AI 为参数命名

Apifox 新增「AI 命名」功能，为参数命名提供智能化建议。结合AI 能力让用户快速获取符合编程规范且语义精准的参数名建议，提升命名的一致性和专业性，让参数命名更加规范。

支持让 AI 对接口进行规范性检测

AI 可以基于接口设计规范，对当前接口文档进行规范性检测，自动识别不符合规范的内容，并提供相应的改进建议，协助团队维护专业、易读、一致、高质量的接口文档。

在线文档功能增强

支持自定义 CSS 和 JavaScript

Apifox 在线文档新增自定义 CSS 和 JavaScript功能，可根据需求灵活定制文档的配色、字体等样式，嵌入 AI 聊天机器人等第三方功能，帮助团队打造更契合品牌调性和使用需求的 API 文档站点。

目录支持设置展示「数据模型」

Apifox 在线文档内容配置新增「数据模型」选项，用户可自由选择是否在左侧目录中展示数据模型，从而使文档结构更加清晰直观，开发者可以更方便地查看数据结构并生成对应的 DTO 模型代码。

支持 Webhook 和 Callback 类型的接口

Apifox 现已支持 Webhook 和 Callback 类型的接口。用户可以轻松定义第三方回调通知，比如支付成功回调，简化了复杂场景的接口设计，为开发团队提供了更灵活的异步通信接口管理方案。

模块支持「模块变量」

Apifox 的「模块」新增支持「模块变量」，对应 Postman 的 Collection 变量，允许每个模块独立定义和管理变量。在导入 Postman 数据时，系统会自动将多个 Postman Collection 对应项目中的不同模块，简化了 Postman 的数据迁移过程，提升接口调试和管理的灵活性。

鉴权能力升级

「文档模式」下支持使用默认鉴权凭证

在「文档模式」下运行接口，可以选择使用接口预设的默认鉴权凭证，也可以根据需要手动设置新的鉴权信息，仅作用于当前调试请求，让接口测试变得更加便捷和可控。

OAuth 2.0 鉴权交互优化

我们对 OAuth 2.0 鉴权流程进行了交互体验优化，除了通过 OAuth 2.0 授权流程获取 Token，还可以直接填写 Token，为 OAuth 2.0 认证提供了更多样化的配置方式，更好地满足不同场景下的认证需求。

当导入的接口设置了 Security 时，可将 Auth 设置为对应的鉴权组件

更新至最新版本的 Apifox 后，当导入 OpenAPI/Swagger 数据时，接口如果设置了 Security，会自动将其 Auth 配置映射到对应的鉴权组件，简化接口导入流程，确保接口安全配置的准确性和一致性。

新增「离线空间」功能

Apifox 上线了「离线空间」功能，提供本地化 API 调试环境，具备核心的 API 调试能力，采用本地文件存储方式，操作简单便捷。适合需要快速测试或不便联网场景下的 API 调试工作，使 Apifox 的使用场景更加灵活多样。

用户反馈优化

支持连接启用了 SSL 的 MySQL、PostgreSQL 数据库

Apifox 支持连接启用了 SSL 的 MySQL 和 PostgreSQL 数据库，可以配置证书、私钥等，为用户提供更安全的数据库连接访问方式，满足不同场景下的安全性需求。

查询、创建 MongoDB 文档时，支持 Date 等 BSON 数据类型

Apifox 扩展了 MongoDB 文档操作的数据类型支持，在查询和创建文档时，支持使用 Date、ObjectId、Timestamp、Decimal128 等多种  BSON 数据类型，提升与 MongoDB 原生数据格式的兼容性，使数据库操作更加精准可靠。

用于生成业务代码的 OpenAPI Generator 升级至 v7.13.0

Apifox 已将用于生成业务代码的 OpenAPI Generator 升级至最新的 v7.13.0 版本，为业务代码生成提供了更稳定、更强大、更高效的支持。

解决调试 Socket.IO 接口时，如果接口返回了空的消息或 ack，界面报错的问题

在最新版本的 Apifox 中，我们修复了 Socket.IO 接口调试时因接口返回空消息或 ack 导致界面报错的问题，提升了 Socket.IO 接口调试的稳定性，让用户能够更顺畅地测试各种消息类型。

了解更多

当然，Apifox 产品团队为大家带来的新功能远不止上方这些：

• 提升了 App 内获取个人消息列表的速度

• 发布在线文档时，可以选择 Socket.IO 的接口

• 自定义角色权限时，支持配置模块功能相关的权限

• 定时任务使用相同运行设置时，可以配置环境/全局变量范围

• 使用 URL 方式导入 OpenAPI/Swagger 数据时，默认回填上次使用的 URL

• 可以在 API 子版本的目录树上导出接口

• 将响应的 JSON 数据提取为响应示例时，会对 JSON 格式化

• 通用接口文档支持分支

• 设置团队成员的项目权限时，支持搜索项目

• 自定义角色权限时，支持配置 Mock 功能相关的权限

• 请求历史中的 SSE 接口支持时间线显示

• 通过 SQL 建表语句（DDL）创建数据模型时，如果字段没有声明 NOT NULL，则导入后默认为允许 NULL

• 使用 apifox-cli 命令行工具执行自动化测试时，会使用客户端内配置的测试场景运行参数

• 优化了调试接口时，接口响应区域的交互