开源的 API 工具上了阮一峰老师的 weekly 推荐，也没有获得几个 star

[rookie2luochao]

• 求几个星星，和改进建议, 项目地址： https://github.com/rookie-luochao/openapi-ui

• OpenAPI-UI 项目简介：

1. 它是一个简单轻量、比 swagger-ui 更美观的 openapi 接口文档，可以快速的生成模拟请求参数并调用 api 请求，UI 设计简洁美观、聚焦实用功能、使用简单方便、对很多信息的填写支持很好（诸如时间、文件、选择多个枚举等等）。
2. 它还提供类似 postman 的手动填写请求信息页面，对比较难填的字段做了填写优化(例如：时间字段、文件字段)。
3. 它有着符合程序猿审美的简洁 UI 布局， 可以快捷模拟上百个字段的请求参数，手动填写 body 数据会提示字段名称和字段类型
4. 可以全局动态配置 Authorization 和接口请求超时时间，省略每个接口去填 Authorization 请求头，可以不同接口都切换不同的等待时间
5. 代码完全开源，还可以基于此项目二次开发(服务器托管公司所有微服务 api 文档，快捷切换选择指定 api 文档进行查阅测试)
6. 基于 react18 + ts5 + vite5 + Docker 技术栈，为前端开发提供一个开发到部署的标准模板

UI 展示

[rookie2luochao]

@james2013 谢谢建议，做好了是要做个包让后端程序加个路由一起发布的，但是现在就想让别人用你的包替换 swaggerUI 谈何容易，主要是想着先建个工具页把功能做好(有人用，挨骂，吸取建议)，再支持框架层接入

[Rache1]

@rookie2luochao #11 倒是没用过，只是很早之前看到过，觉得不错。

不过就 API 文档而言的话，量大的话，我还是比较能接受 SAAS 的，自己搭建的靠谱程度太低。

如果只是给开发人员用，Jetbrains 家的 HTTP Client 也够用，甚至少量 API 的话，都是直接写个 markdown 放到 Git 仓库就好了。

---

以前用主要用 POSTMAN ，但是前不久的一次更新，POSTMAN 变成了强制登录，就不用了。

[xianyv]

@rookie2luochao #11 我觉得挺好用的,UI 也还算不错

[rookie2luochao]

@huangliu 说明大佬你做的东西还是很新颖吧

[zhw2590582]

@rookie2luochao #9 你自己都说"自己用一下"，"玩一玩", "不会投入过多精力"，这种维护的心态怎么会得到很多 star 啊？

[rookie2luochao]

@zhw2590582 你说的确实是事实，其实获得 star 并不是我的目的，我其实想有人用，然后一起把它做好，后面做个包让框架接入，但是个人眼光和精力有限，需要找人一起维护建设

[rookie2luochao]

@xianyv 可能你和我一样属于接触中台项目，觉得 UI 就还凑合了，谢谢同学的鼓励

[rookie2luochao]

@Rache1 也是第一次做这种页面工具，确实有很多经验需要学习, postman 我每次翻墙了打开都特别慢

[NerbraskaGuy]

网页端项目如果没有专门的设计师，可以用 antd 之类这些现成的 UI 框架，上手也没啥门槛

[rookie2luochao]

@NerbraskaGuy 就是用的 antd 开发的，😭

[NerbraskaGuy]

@rookie2luochao #30 额 好吧 没仔细研究 那要不请个外包设计师吧😂

[rxmt]

作为白嫖怪，这个还挺好的，postman insomnia 都要求登录，隔壁的 reqable 如果只是用 api 管理只能创建 2 个集合，多了要充钱。
---

有个小需求，baseUrl 可不可以支持更改，比如我在 docker 配一个 env ，OPEN_API_BASE_URL /api_tool 。因为我们有的服务器 terminal 用堡垒机连，对外接口只给开个 80 。然后路由到这个服务上的时候，然后一些资源变成 http://host/assets/... 就访问不到了。非运维，不太了解是不是我不会配，还是这种情况不好处理。

[rxmt]

已 star ，加油！

[YVAN7123]

阮一峰老师的 weekly 我只看新闻。。。

[rookie2luochao]

@rxmt 请问这个 baseURL 可不可以改要怎么理解呢，现在是这样的逻辑：假如你的 openapi 文档地址是 www.api.com/myapi.json ，那么 baseURL 默认就是 www.api.com ，你的所有请求会用 https://www.api.com/get/user ，b 按这个道理 baseURL 是可以改的，当然我也可以加一个配置让你自己强行指定 baseURL

[rxmt]

@rookie2luochao 奥奥，不是使用逻辑，是这个工具本身部署。就是我的 nginx port 80 ，docker 8081:80
location /api_tool { proxy_pass http://127.0.0.1:8081/ }，这个时候，http://host/api_tool 的时候，一些资源文件（例如：/assets/*）会从 http://host/assets/*里面找，这个其实就找不到了。那我得再配置/assets 到 127.0.0.1:8081/上，但我不想影响 rootPath 上的目录。

那我如果 location /api_tool { proxy_pass http://127.0.0.1:8081 }，同时前端页面的那个 base path 变成了/api_tool ，就没有访问问题了吧？

[archxm]

阮老师的私货太多了，开头都是几条政治正确的新闻内容

[rookie2luochao]

@rxmt 你可以尝试一下，我一般反向代理也是这样玩的，location /api_tool { proxy_pass http://127.0.0.1:8081/ }，docker -e 是支持环境变量注入的，你可能需要 fork 一下我这个库的代码改一下，如果这个功能确实很重要，你可以私底下加我一起交流，看怎么能帮到你

[Braisdom]

我的项目之前也想上阮老师的周刊，看样算了，还不发 V 站来的流量多呢： https://www.agiquery.com

哈哈，现在都不太敢推了，有人看了反感，等新版本发布的时候，再推吧。

[jqtmviyu]

swagger + postman 又不是不能用. 没有颠覆性的功能, 又没大的提升, 确实没有尝试的动力 .