Api官网帮助地址

Apifox IDEA 插件快速上手 | Apifox 帮助文档

特别注意:

1、idea版本必须大于2019.03才可以使用这个插件

2、修改设置不然分组校验必填项,apifox里面显示都是必填

添加图片注释,不超过 140 字(可选)

介绍

Apifox IDEA 插件(Apifox Helper) 主要用于 IDEA 项目快速生成 API 文档,并同步到 Apifox,代码零入侵。

  • 基于 javadoc(Java)、KDoc(Kotlin)、ScalaDoc(Scala) 解析 API 文档。
  • 支持 Swagger 注解。
  • 注意:可以在保持代码零侵入的情况下得到相当完整的 API 文档,但是特殊的需求还是需要部分特殊的 注释/注解配合。
  • 该插件基于 easy-api 定制开发,感谢 easy-api 作者。

功能特性

  • 导出 API 文档到 Apifox
  • 导出 Markdown 格式 API 文档
  • 在 IDEA 中直接发起 API 请求

支持项列表

默认支持额外(配置)支持
语言java, kotlinscala
webspring, feign, jaxrs (quarkus / jersey)dubbo
常用框架javax.validation, Jackson, Gsonswagger

安装

支持以下 IDEA

  • IntelliJ IDEA 193.+(2019.3+)
  • IntelliJ IDEA Community Edition 174+(2017.4+)

从 Jetbrains Marketplace 官网安装

https://plugins.jetbrains.com/plugin/20549-apifox-helper

从 IDEA plugins 中搜索安装

打开IDEA > File > Preferences(Settings) > Plugins,搜索 Apifox Helper。

添加图片注释,不超过 140 字(可选)

本地安装

  • 你可到插件市场选择对应版本 下载插件。
  • 下载完成后,打开 IDEA,选择File > Preferences(Settings) > Plugins > Install plugin from Disk导入插件。
  • 插件导入完毕,需重启 IDEA。

获取项目 ID

打开项目设置——基本设置,复制项目 ID。

添加图片注释,不超过 140 字(可选)

获取访问令牌

Apifox 的 个人访问令牌 可在你的头像 > 账号设置 > API 访问令牌里获取。

基础配置

安装插件后,进入设置界面Preferences(Settings) > ApifoxHelper。

添加图片注释,不超过 140 字(可选)

基本的配置如下:

  • Apifox 服务器地址: 填写 Apifox API 服务地址,SaaS 版默认为 https://api.apifox.cn
  • Apifox 个人访问令牌:获取令牌可参考文档 获取访问令牌
  • 模块项目 ID 配置: 代码模块名和项目 ID 的映射关系配置,其中项目 ID 的获取可参考文档 获取项目 ID

模块项目 ID 配置

每个 Module 都需指定一个项目 ID,可选指定目标目录名。

  • 如下填写,表示的是 mall-admin 和 mall-search 模块都导入到项目 2051427 且都是导入到根目录。
mall-admin:2051427mall-search:2051427
  • 如下填写,表示的是 mall-admin 和 mall-search 模块都导入到项目 2051427,分别导入到 管理后台、搜索目录下。
mall-admin:2051427,管理后台mall-search:2051427,搜索
  • 多级目录用/分割,如下填写,表示的是 mall-admin 和 mall-search 模块都导入到项目 2051427,分别导入到商城/后台管理、商城/商城搜索目录下。
mall-admin:2051427,商城/后台管理mall-search:2051427,商城/商城搜索

框架配置

针对特定框架,Apifox插件支持选择远程配置和添加自定义的远程配置 URL。

添加图片注释,不超过 140 字(可选)

同步接口到 Apifox

同步模块内所有接口

  • 在模块目录上的右键菜单中选择 Upload to Apifox

添加图片注释,不超过 140 字(可选)

同步 controller 文件内所有接口

  • 在代码编辑区域的右键菜单中选择 Upload to Apifox

添加图片注释,不超过 140 字(可选)

同步选择部分接口

  • 在模块目录上或代码编辑区域的右键菜单中选择 Export API

添加图片注释,不超过 140 字(可选)

  • 选择想要同步的单个或部分接口,回车执行同步请求

添加图片注释,不超过 140 字(可选)

常见问题

  • 常见的一些使用场景,如 怎么设置接口 API 所属文件夹的名称 、 如何添加配置文件、 如何增加外层的公共返回响应 Response 泛型 、 如何适配 Mybatis Plus 工程的分页 Page 模型和请求参数 ,参考 常见问题文档。
  • 自定义配置,参考 配置文档。