• 0
  • 0
分享
  • Apifox IDEA 插件 | 帮助开发者快速生成 API 文档!
  • Apifox 2023-02-20 15:27:19 字数 1491 阅读 1760 收藏 0

Apifox 已推出 IDEA 插件 「Apifox Helper」 。Apifox Helper 是一款集成在 IDEA 中,帮助开发者自动解析代码注解并快速生成 API 文档的便捷工具。 Apifox Helper 是基于 javadoc(Java)、KDoc(Kotlin)、ScalaDoc(Scala)解析 API 文档,支持 Spring Boot、Swagger、JAX-RS 等协议框架,基本可以实现代码零入侵自动生成接口文档。

1.png

在 IDEA 中使用 Apifox Helper 可以一键同步文档到 Apifox 项目中,开发者无需切换工具,即可更新同步文档给团队内其他人员。自动解析注解、快速同步文档、IDEA 内调试、Apifox 便捷团队协作,你只需一个「Apifox Helper」。

接下来给大家演示如何使用。

安装 & 配置

首先,需要在 IntelliJ IDEA 安装并且配置令牌。打开 Preferences(Settings) > Plugins ,搜索 Apifox Helper 点击安装即可。

你也可以从 Jetbrains Marketplace 的官网下载安装。

2.png

安装成功后,要将 IDEA 内的项目与 Apifox 的项目进相关联,需要配置令牌。进入设置界面 Preferences(Settings) > Apifox Helper 中填写 Apifox 服务器地址、个人访问令牌、项目 ID:

Apifox 服务器地址:默认 Apifox API 服务地址为 *https://api.apifox.cn*,无需修改。

Apifox 个人访问令牌:在 Apifox 个人头像处的「账号设置 --> API 访问令牌」,新建令牌后复制生成的 Token 填写即可。

模块项目 ID 配置:这项主要是进行代码模块名和项目 ID 的映射关系配置,在 Apifox 中进入项目中「项目设置 --> 基本设置」,复制项目 ID 粘贴过来。

3.png

完成以上配置操作,就可以实现文档自动生成、同步、在线调试、导入导出等功能了。

自动生成 API 文档

使用「Apifox Helper」可直接自动解析代码注解,代码零入侵。右键点击「 Upload to Apifox」即可生成完整的 API 文档并同步到 Apifox 项目中 ,无需导出操作。团队成员即可在 Apifox 项目中完成接口调试、自动化测试等工作。

4.png

接口信息一键更新同步

当在 IDEA 项目中有接口信息变动,只需右键点击「 Upload to Apifox」一键即可完成同步, 无需奔走相告。团队成员可在 Apifox 中看到同步后的最新内容。

5.png

此外,使用 Apifox Helper 可以在 IDEA 中一键发起接口内测,同时支持导出 Markdown 格式文档和 cURL,适应不同团队的协作方式。

结合 IDEA 插件,我们推荐代码先行的团队 API 协作实践方式如下:

后端开发者:在 IDEA 中安装 「Apifox Helper」,随时编写/调试,随时更新同步;

前端开发者:在 Apifox 中查看最新文档,进行接口调试、API Mock ;

测试工程师:在 Apifox 中获取最新接口信息,编写/保存测试用例、进行自动化测试。

让后端开发者只需一个「Apifox Helper」即可在 IDEA 中完成 API 协作所需的工作。

6.png

现在出发,在 IDEA 内 「plugin」入口搜索「Apifox Helper」下载试试吧!

想了解更多关于插件的内容可以前往 Apifox 官方帮助文档查看:apifox.cn


  • 【留下美好印记】
    赞赏支持
登录 后发表评论
+ 关注

热门文章

    最新讲堂

      • 推荐阅读
      • 换一换
          • 1.测试背景为了保证XX项目测试工作的组织性,提高测试的工作质量和效率,为XX项目测试工作提供完整的测试计划、测试人员工作安排、测试轮次、测试方法、系统功能模块覆盖率以及测试风险分析,确保测试项目平稳有序的运行。2.测试目标XXXX测试项目的测试目标为:接口程序覆盖率100%,接口错误修改率100%;测试案例的功能覆盖率达100%,执行率达100%;已修改的测试问题回归测试覆盖率达100%;测试记录闭环率达95%。3.测试范围测试计划和设计:根据软件需求说明书,制定测试计划,测试方案,包括收集测试方法,测试用例,测试工具等;单元测试:根据系统详细设计,制定测试计划,测试方案。此项由开发人员自测...
            1 0 5212
            分享
          •   一项新的研究显示,工作经验对员工如何与人工智能互动有很大影响。拥有更多特定任务经验的员工从人工智能中获益更多,而资深员工则由于担心人工智能的不完善而不太可能信任人工智能。研究结果强调,在工作场所整合人工智能时,需要采取量身定制的策略,以加强人与人工智能的团队合作。  新的研究揭示了人类与人工智能互动的复杂方面,凸显了一个令人惊讶的趋势:人工智能系统倾向于使初级员工受益,但原因却不尽如人意。  发表在 INFORMS 期刊《管理科学》(Management Science)上的最新研究为企业领导者提供了关于工作经验对员工与人工智能互动的影响的宝贵见解。  这项研究探讨了人类工作经验的两种主要...
            0 0 391
            分享
          • 一、Restful接口实例通过构建一个Restful接口实例,更加直接深入了解Restful接口的开发。二、构建一个简单实例1.创建项目参考https://blog.csdn.net/u010886217/article/details/852391102.项目结构Maven项目结构3.创建第一个controller测试类:HelloworldControllerpackage com.example.demo; import org.springframework.web.bind.annotation.GetMapping; import org.spring...
            0 0 4084
            分享
          • 1、引言小屌丝:鱼哥,啥是认证,啥是鉴权?小鱼:嗯?? 做了这么多年码农,这个还不知道呢?小屌丝:唉~~ 没整明白啊,能不能给我讲一讲啊小鱼:好吧,正好今晚有时间,我就把 认证、鉴权、授权及权限控制这点事,都给你说一说。小屌丝:奈斯啊。2、鉴权方案2.1 认证定义:认证(Identification) :是指根据声明者所特有的识别信息,确认声明者的身份。常见的认证技术:身份证;用户名和密码;用户手机:手机短信、手机二维码扫描、手势密码;用户的电子邮箱;用户的生物学特征:指纹、语音、眼睛虹膜;用户的大数据识别;2.2 鉴权定义:鉴权(Authentication) :在信息安全领域是指对于一个声...
            1 0 6298
            分享
          •   最近,YouTube Music与双子座聊天机器人(Gemini chatbot)进行了整合,这款音乐流媒体应用程序正在特斯拉电动汽车中找到新家,从而扩大其覆盖范围。最新的特斯拉软件更新版本 2024.26 包括对 YouTube Music 应用程序的支持等多项功能。  在特斯拉中使用 YouTube 音乐应用程序需要向汽车制造商订购每月 10 美元的高级连接服务。根据发布说明,另一种方法是使用手机创建 Wi-Fi 热点。  使用 YouTube Music Premium 收听超过 1 亿首歌曲。访问你的资料库,查看你喜欢和添加的所有歌曲、你创建的播放列表以及你订阅的艺术家和播客。  ...
            0 0 264
            分享
      • 51testing软件测试圈微信