Apifox 8 月更新|新增测试用例、支持自定义请求示例代码、提升导入/导出 OpenAPI/Swagger 数据的兼容性

Apifox 新版本上线啦!看看本次版本更新主要涵盖的重点内容,有没有你所关注的功能特性:

  • 支持为接口创建「测试用例」
  • 「在线文档」支持更多个性化配置
    • 支持自定义请求示例代码
    • 支持自定义首页
  • 支持自动备份每个模块对应的 OpenAPI/Swagger 文件到 GitLab 仓库
  • 支持一次性导入 Postman 多个 Collection (dump data)
  • 提升导入/导出 OpenAPI/Swagger 数据的兼容性
  • 用户反馈优化
    • 解决当数据模型中的数组元素引用数据模型本身时,接口文档无法正常预览的问题
    • 解决下载返回的响应时,文件扩展名不正确的问题
    • 解决数据库连接配置中如果使用了名称包含大写字母的变量,就无法正常连接的问题
    • 解决无法使用 SSH 隧道连接启用了 SSL 的 MySQL、PostgreSQL 数据库的问题

将 Apifox 更新至最新版,一起开启全新体验吧!

支持为接口创建「测试用例」

Apifox 新增「测试用例」功能,帮助用户更好的进行单接口测试。在接口详情页中可以创建和管理多个测试用例,每个测试用例代表一组特定的请求参数值,覆盖不同的请求场景。用户可一键运行所有测试用例并查看测试报告,快速验证接口在各种请求情况下的行为是否符合预期,提高测试效率,帮助团队更全面评估接口质量,增强接口测试的系统性和全面性。

更多关于测试用例的内容,可以查看帮助文档中的「接口测试用例」部分。

「在线文档」支持更多个性化配置

支持自定义请求示例代码

发布 API 在线文档时,支持配置是否展示自动生成的请求代码 。用户可以自行选择需要自动生成的语言或类库,并支持自定义代码内容,使 API 文档更贴合团队的开发规范与偏好。

设置路径:项目设置 -> 通用设置 -> 功能设置 -> 接口功能设置 -> 请求示例代码

支持自定义首页

在线文章新增「自定义首页」功能,支持使用 Markdown 或通过 HTML 配合 CSS 和 JavaScript 打造个性化的 API 文档入口页面,让团队能够灵活创建更具特色的文档首页,充分体现团队特色和品牌形象。

支持自动备份每个模块对应的 OpenAPI/Swagger 文件到 GitLab 仓库

更新至最新版的 Apifox 后,支持将各个模块的 OpenAPI/Swagger 文件自动备份到 GitLab 仓库,为 API 文档提供了更高效的版本控制和备份机制,使团队能够轻松将接口文档集成到 GitLab 的代码管理工作流,便于更好地掌控 API 规范。

支持一次性导入 Postman 多个 Collection (dump data)

优化了 Postman 数据导入功能,支持一次性导入多个 Collection(dump data),每个 Collection 自动转换为 Apifox 中的「模块」。实现高效数据批量迁移,节省大量时间并确保数据迁移的完整性和准确性。

提升导入/导出 OpenAPI/Swagger 数据的兼容性

Apifox 对 OpenAPI/Swagger 数据的导入导出兼容性方面进行了优化,并解决了与多模块相关的一些问题:

  • 修复 requestBody 的 content 为空对象时,出现 Cannot read properties of undefined (reading: 'schema') 报错且无法导入的问题
  • 修复在请求 Body 的字段名引用了数据模型的接口,导出后 Body 内没有任何字段的问题
  • 修复接口根目录的前后置操作丢失的问题,确保重要的操作配置得以完整保留
  • 当导入接口的 Security 为 JWT Bearer 时,调试此类接口时可以直接输入 Token,而不是通过填写密钥、Payload 等内容生成 Token
  • 如果跨模块引用了组件,导出模块数据时,引用的组件也会被同时导出,确保导出数据的完整性和可用性

我们将继续优化 OpenAPI/Swagger 数据的导入导出功能,致力于为用户提供更加标准、易用的使用体验。

用户反馈优化

解决当数据模型中的数组元素引用数据模型本身时,接口文档无法正常预览的问题

最新版本的 Apifox 修复了数据模型中的数组元素自引用导致接口文档无法正常预览的问题,确保接口文档可以清晰完整地展示嵌套的数据模型,提升文档的兼容性和可读性。

解决下载返回的响应时,文件扩展名不正确的问题

我们修复了下载返回的响应时可能会出现扩展名不正确的问题,确保下载文件格式与实际内容一致,进一步提升了用户体验。

解决数据库连接配置中如果使用了名称包含大写字母的变量,就无法正常连接的问题

我们修复了因数据库连接配置中使用包含大写字母的变量名称而导致无法正常连接的问题,确保变量命名不再影响数据库连接的正常建立,提升连接的稳定性和可靠性。

解决无法使用 SSH 隧道连接启用了 SSL 的 MySQL、PostgreSQL 数据库的问题

我们已修复此前无法通过 SSH 隧道连接启用了 SSL 的 MySQL 和 PostgreSQL 数据库的问题,为数据库访问场景提供了更完善的支持,使数据库连接更加安全和可靠。

了解更多

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

  • 解决当 gRPC 的不同 Package 拥有同名的 Service 或 Message 时,通过 gRPC 服务器反射导入的接口无法调试的问题
  • 解决数据库操作中无法连续使用多条 SET 语句的问题
  • 模块页面会显示模块变量的数量
  • 导入数据到模块后,不再会自动创建根目录
  • 支持导入较大的 Postman Collection
  • 切换响应 Body 的展示模式后,再次发送请求,该模式不会被重置为 「Pretty」
  • 测试场景会记住上次保存的「运行于」设置
  • 解决自托管 Runner Mock 无法运行新创建的模块内接口的问题
  • 解决调整了接口文档内响应体的顺序后,Mock Server 没有返回第一个响应体的问题
  • 解决当接口的鉴权方式为「继承」时,无法将鉴权凭证切换为「手动设置」的问题
  • 解决使用快捷请求时,如果响应内容是图片,继续请求其他图片后,预览始终展示首张图片的问题
  • 解决无法编辑实际请求 Tab 的请求代码的问题
  • 解决运行测试场景时,如果接口响应较大,界面卡顿的问题
  • 解决导入 Postman Collection 为新模块时,模块名称不正确的问题

除了新增功能,我们也对产品细节和使用体验进行了优化,具体修改内容可前往 Apifox 更新日志查看。

欢迎各位用户对 Apifox 继续提出使用反馈和优化意见,我们会持续优化更新,致力于为用户提供更优秀的产品功能与更极致的使用体验!

可以前往帮助文档查看更多使用说明和操作,在使用过程中有有任何问题或建议,欢迎在 Apifox 用户群与我们交流沟通。

相关推荐
code_Bo23 分钟前
不只命令行:我把跨 Agent 会话同步做成了桌面应用
前端·javascript·后端
kyriewen37 分钟前
AI 能把页面写出来,为什么改个需求就开始崩?
前端·javascript·人工智能
用户8356290780511 小时前
使用 Python 控制 Excel 工作表的分页位置
后端·python
用户8356290780511 小时前
Python 如何在 Word 中添加和管理文档变量
后端·python
涛涛ing2 小时前
2026年最值得关注的前端变化,藏在“默认值”里
前端
量化分析码农2 小时前
股票历史数据的复权参数对照:多级别返回的字段与数值差异
java·javascript·后端
程序员cxuan3 小时前
讲真,智能路由这事儿,还得看基元律动
人工智能·后端·程序员
亿元程序员4 小时前
太牛了!这AI做出来的游戏,居然还能变现!
前端
vaskilab4 小时前
Schema 全绿,Agent 却把参数编造了
后端
hellice4 小时前
闪传 FlashDrop 实战:我用 300 行 Node 代码做了个「4 位取件码」临时文件中转站
前端·产品