apifox helper插件必须搜全名“apifox helper”安装并重启idea才生效；配置需填对api访问令牌和32位项目id，否则上传静默失败；右键upload to apifox作用范围取决于所选节点，且上传后须在apifox桌面端手动点击刷新按钮。

Apifox Helper插件装不上？先确认名字和重启

装不上基本是因为搜错了名字，或者没重启 IDEA。插件市场里必须搜 Apifox Helper，不是 Apifox 也不是 Apifox Uploader —— 搜错就找不到。装完必须点 Restart IDE，否则 Settings 里压根不显示配置入口，右键菜单也不会出现 Upload to Apifox。

如果插件市场加载慢，直接去 JetBrains Marketplace 官网 下载 .zip 离线安装。社区版 IDEA（2017.4+）和旗舰版（2019.3+）都支持，但低于 2017.4 的版本无法启用。

访问令牌和项目 ID 填错，上传会静默失败

没填或填错 API 访问令牌 和 项目 ID，插件连不上 Apifox 后端，所有上传操作都会静默失败，控制台不报错、也不弹提示 —— 这是最常被忽略的卡点。

• API 访问令牌 获取路径：Apifox 桌面端 → 左上角头像 → 账号设置 → API 访问令牌 → 新建令牌 → 复制生成的字符串（形如 apifox_abc123）
• 项目 ID 获取路径：Apifox 项目页 → 项目设置 → 基本设置 → 复制 32 位十六进制字符串（如 5f8a1b2c3d4e5f6a7b8c9d0e1f2a3b4c）
• IDEA 配置位置：File → Settings → Other Settings → Apifox Helper → 填入两项 → 点击 Test Token 验证连通性

右键 Upload to Apifox 传什么，取决于你点哪

这个右键菜单不是全局功能，它只对当前选中节点生效，行为差异很大：

Idealista Cli

使用 idealista CLI 按位置（城市、城镇、地区、街道）搜索 Idealista 房源并获取详情。适用于用户请求 Idealista 市场数据或需要 idealista‑cli 命令/标志时。

下载

• 在 @RestController 类名上右键 → 上传该 Controller 下所有 @RequestMapping 方法
• 在某个 @PostMapping 方法上右键 → 只上传这一个接口，适合调试或临时补录
• 在 src/main/java 目录上右键 → 尝试扫描全部 Controller，但可能因包结构复杂漏掉某些类
• 如果 Controller 用了非标准注解（比如自定义路由注解），Upload to Apifox 默认不识别，需额外加 @ApiOperation 或 @Api 注解辅助解析

调试面板打不开？检查右侧工具栏和首次扫描耗时

重启 IDEA 后，右侧工具栏应该出现 Apifox 图标。点击它才会打开调试面板 —— 不是靠右键触发。首次打开时会全盘扫描代码，时间取决于项目大小，大项目可能卡住几秒甚至十几秒，别误以为挂了。

扫描完成后，树状视图展示所有接口；点击任一接口，下方调试面板自动填充请求方法、路径、参数、Header、Body 等字段。注意：代码改了之后，得手动点刷新按钮，否则树状视图不会自动更新。

真正容易被忽略的是：Apifox 桌面端右上角那个刷新按钮，上传后必须点一下，否则新接口不会出现在文档列表里 —— 不是同步延迟，是前端没拉新数据。

大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！