掘金 人工智能 07月31日 09:51
Apifox 7 月更新|通过 AI 命名参数及检测接口规范、在线文档支持自定义 CSS 和 JavaScript、鉴权能力升级
index_new5.html
../../../zaker_core/zaker_tpl_static/wap/tpl_guoji1.html

 

Apifox最新版本重磅上线,本次更新聚焦AI在接口设计领域的应用,新增AI辅助参数命名及接口规范性检测功能,显著提升开发效率与文档质量。同时,在线文档功能得到强化,支持自定义CSS/JS,目录可展示数据模型,并新增Webhook和Callback接口类型。模块变量、鉴权能力升级(支持文档模式默认鉴权、OAuth2.0优化、导入时自动映射鉴权组件)以及新增离线空间功能,进一步拓展了Apifox的应用场景。此外,对数据库连接、MongoDB数据类型、OpenAPI Generator和Socket.IO调试等进行了多项用户反馈优化,致力于提供更流畅、更全面的API开发体验。

🚀 **AI赋能接口设计与规范**:Apifox引入AI能力,可为参数提供智能化命名建议,提升命名规范性和专业性。同时,AI能对接口文档进行规范性检测,识别并提出改进建议,助力团队维护高质量的接口文档。

✨ **在线文档功能增强与灵活性提升**:在线文档现支持自定义CSS和JavaScript,允许用户根据品牌调性或需求定制文档样式,甚至嵌入第三方功能。目录结构也得到优化,可选择展示“数据模型”,使接口结构更清晰。此外,新增对Webhook和Callback类型接口的支持,简化了异步通信接口的管理。

🔗 **模块化管理与鉴权能力强化**:新增“模块变量”功能,允许每个模块独立管理变量,并优化了Postman数据迁移的兼容性。鉴权能力方面,文档模式下支持使用默认鉴权凭证,OAuth 2.0流程交互更优化,导入接口时能自动映射鉴权组件,提升了接口测试的便捷性和安全性。

🏠 **新增离线空间与多项用户反馈优化**:Apifox上线“离线空间”功能,提供本地化API调试环境,满足特定场景下的调试需求。同时,优化了SSL数据库连接、MongoDB BSON数据类型支持、OpenAPI Generator版本升级,并修复了Socket.IO调试的报错问题,全面提升了用户使用体验。

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 产品团队为大家带来的新功能远不止上方这些:

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

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

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

Fish AI Reader

Fish AI Reader

AI辅助创作,多种专业模板,深度分析,高质量内容生成。从观点提取到深度思考,FishAI为您提供全方位的创作支持。新版本引入自定义参数,让您的创作更加个性化和精准。

FishAI

FishAI

鱼阅,AI 时代的下一个智能信息助手,助你摆脱信息焦虑

联系邮箱 441953276@qq.com

相关标签

Apifox AI 接口设计 API文档 开发工具
相关文章