【Apifox Helper】自动生成接口文档,IDEA+Apifox懒人必备

这篇具有很好参考价值的文章主要介绍了【Apifox Helper】自动生成接口文档,IDEA+Apifox懒人必备。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

前言

🍊缘由

接口文档对接爽,整理起来真费脑

对于整理API文档,本狗秉承偷懒为上的原则,想找一种在IDEA中直接生成文档的方法。Apifox Helper绝绝子,只需要在IDEA中下载插件,无脑配置后,文档自动生成到Apifox,美完美解决。并且颜值及方便程度绝比Swagger和postman好太多。

⏲️本文阅读时长

约10分钟

🥮前置条件

1. IDEA开发工具
2. Apifox(不必要)

🎯主要目标

一秒生成接口文档

🍩水图

IDEA中项目接结构图

apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide

想了解上图模块分层方法的同学,可以参考《还不会SpringBoot项目模块分层?来这手把手教你》

生成到Apifox接口文档图

apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide

👨‍🎓试用人群

1. 像本狗一样【偷懒】不愿意整理接口文档
2. 学习新颖文档生成及管理方式

正文

🐋1.在IDEA安装【Apifox Helper】插件

点击File=>Settings,找到Plugins,输入 Apifox Helper,点击安装,然后等待成功后重启IDEA,一定重启才会生效!!!

apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide
apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide

🎯Tips: 你可以选择同步到 Apifox 项目中,也可以直接导出 markdown 文档。如果是同步到 Apifox 项目,你还需要下载或注册 Apifox 软件,并查看下面【Apifox Helper】的配置规则。如果不需要则只需要在项目中找到需要生成文档的Controller,右键后Export Markdown,直接导出apifox-api.md到对应目录。

apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide

打开apifox-api.md文件查看

apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide


🦢2.修改【Apifox Helper】对应配置

点击File=>Settings=>Other Settings,找到 ApifoxHelper

apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide

1. Apifox服务器地址

https://api.apifox.cn

2. API访问令牌

打开Apifox软件,点击左侧【头像】,点击【账号设置】,找到API访问令牌

apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide
apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide


点击新建令牌,填写名称及有效期,本狗填写名称为【IDEA专用】,有效期为【无限期】,点击【保存并生成令牌】

apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide


复制令牌到IDEA中【Apifox Helper】配置项的API访问令牌

apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide
apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide

3. 模块项目ID配置

打开Apifox软件,新建项目,本狗项目名为【bkb】,并确认

apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide
apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide


进入项目【bkb】,点击【项目设置】,点击【基本设置】,复制项目ID

apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide
apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide


将上述复制的【ProjectID】到IDEA中【Apifox Helper】配置【模块项目ID配置】,我的ModuleName为【bkb-boot-controller】,所以结构是bkb-boot-controller:xxxxx,点击【OK】

apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide
apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide


🌈3.生成文档

右击【bkb-boot-controller】模块,点击 【Upload to Apifox】,等待完成即可

apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide
apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide


🍎4.查看Apifox中自动生成的文档

一定要点击下Apifox软件右上角的刷新!
一定要点击下Apifox软件右上角的刷新!
一定要点击下Apifox软件右上角的刷新!

apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide

查看成果,大功告成,之后便可为所欲为了

apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide


写在最后

此生两悔,悔遇见你,更悔未早遇见你。

411天

apifoxhelper,工具,IDEA,Apifox,intellij-idea,java,ide文章来源地址https://www.toymoban.com/news/detail-784644.html

JavaDog 狗屋地址
个人博客 https://blog.javadog.net
公众号 https://mp.weixin.qq.com/s/_vgnXoQ8FSobD3OfRAf5gw
CSDN https://blog.csdn.net/baidu_25986059
掘金 https://juejin.cn/user/2172290706716775
知乎 https://www.zhihu.com/people/JavaDog
简书 https://www.jianshu.com/u/1ff9c6bdb916
gitee https://gitee.com/javadog-net
GitHub https://github.com/javadog-net

到了这里,关于【Apifox Helper】自动生成接口文档,IDEA+Apifox懒人必备的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • 【web】Fastapi自动生成接口文档(Swagger、ReDoc )

    FastAPI是流行的Python web框架,适用于开发高吞吐量API和微服务(直接支持异步编程) FastAPI的优势之一:通过提供高级抽象和自动数据模型转换,简化请求数据的处理(用户不需要手动处理原始请求数据),并能根据路由和 Pydantic 模型自动生成 OpenAPI 接口文档。 Swagger UI ReDo

    2024年02月04日
    浏览(41)
  • 读取swagger接口文档、自动生成前端ts或js代码

    平时在和后端对接时,总是要把后端swagger声明好的类型在ts中再实现一遍,写一堆interface;今天推荐一个库,可以根据swagger文档,直接生成ts 或 js代码,并且有良好的代码提示 注意:swagger文档版本需要3.0及以上 我这里快速创建下 然后创建一个 swagger.config.json 文件 配置示例

    2024年02月13日
    浏览(32)
  • 如何使用apifox打包测试用例生成测试套件自动化执行

    1、首先点击自动化测试--创建测试用例--新建分组(整理每个模块对应的测试用例),右键点击对应的分组新建测试用例,开始创建测试用例。 2、创建测试用例:输入对应的名称,以及用例执行的优先级(核心、高、中、低),添加对应的用例备注(说明)  3、编辑测试用

    2024年02月11日
    浏览(44)
  • 【Apifox】测试工具自动编写接口文档

    在开发过程中,我们总是避免不了进行接口的测试, 而相比手动敲测试代码,使用测试工具进行测试更为便捷,高效 今天发现了一个非常好用的接口测试工具Apifox 相比于Postman,他还拥有一个非常nb的功能, 在接口的测试完成后,它可以一键生成接口文档 下载地址(免费哟

    2023年04月09日
    浏览(37)
  • Idea - Apifox Helper 插件的安装、配置令牌、导出

    等待安装完毕 提示我们没有找到配置文件,需要到设置里面设置Personal Access Token 先到官网登录并点击账号设置 选择新建令牌: 填写名称设置有效期然后保存再点击令牌即可复制: 粘贴到箭头处并根据设置匹配到相同接口时操作: 再次重新导出指定Project ID即可!

    2024年02月06日
    浏览(36)
  • 自动生成数据库设计文档,支持多数据源批量生成(Word文档)

          在做项目时通常使用PowerDesigner设计数据库,但在项目完成交付项目给客户的时候常常需要一份Word版本的数据库文档给客户,你不能指望每个客户都会用PowerDesigner,所以基于当前开发数据库生成数据库文档就是最佳选择,如果手动编写数据库文档那将是一件非常痛苦的

    2024年04月23日
    浏览(40)
  • 【IDEA】idea不自动生成target

    本文描述idea不生成target的几种情况以及处理方法 像下图这样根本就不生成target文件夹的,首先考虑环境问题。有没有把项目正确导入进idea、jdk有没有配置等原因 上图很明显模块p6spy显示的是普通文件夹而不是maven项目。 解决方法: 正确导入maven项目到idea(如果项目文件夹显

    2024年02月15日
    浏览(42)
  • Apikit 自学日记:自动生成 API 文档

    功能入口 :API管理应用 / 选中某个项目 / 其他菜单 / 数据源同步(API文档自动生成) 该功能可通过配置数据源信息,实现基于数据源的API信息自动生成API文档。 当前支持5种数据源: Swagger URL、apiDoc、Github、gitlab、码云 。 Swagger URL和apiDoc的数据源配置方式一致,仅需填写来

    2024年02月11日
    浏览(40)
  • Mongodb 集合插入文档自动生成ObjectId

    Mongodb 使用以下几种方法来插入文档 , Mongodb V5.0+ 使用 mongosh 客户端: 插入单个文档 db.collection.insertOne() 将单个 文档插入到集合中。 如果该集合当前不存在,则插入操作将创建该集合。 如果文档未指定_id字段,则将在插入之前 mongod 添加该字段并为文档_id分配唯一的字段

    2024年02月12日
    浏览(40)
  • word文档批量生成工具(附免费软件)(按Excel表格内容自动替换内容生成文档)

    批量生成word文档是让人无比厌恶但有时又不得不做的事情。比如学校要给拟录取的学生发通知书,就可能需要批量生成一批只有“姓名”、“学院”和“专业”不同,其他内容都相同的word文档以供打印(事实上直接生成pdf是更好的选择,这个以后有心情可以弄一下)。 要实

    2024年02月11日
    浏览(40)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包