开源的 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]

@hanxiV2EX 阮老师的力量看来还是很强，就看自己抓的住流量不

[rookie2luochao]

@huangliu 抱歉哈，突然发现有点社死，规则都没搞明白😭

[lidawn]

好家伙，一件价保，回本 23 块

[lidawn]

@lidawn 回错帖子了

[lvjiaxuan818]

我擦，我投过一次，只涨了 10 几个 star ，

[lyang]

@rookie2luochao 有博客和公众号的，直接搜就能搜到

[flyingcrp]

额...基于 swagger 的模式横行了几十年.现在有另一种,你要不要尝试
文档与代码分离;我试验了几个项目,目前来说最顺手的就是 apifox 了.
强制结构校验,并发测试. 集成测试. 设计+协同.
虽然它协议有那么一点点搞,.

[rookie2luochao]

@flyingcrp 没有太理解大佬你说的这个文档与代码分离，求指引

[rookie2luochao]

@lyang 我以前没有认真看周刊，现在知道怎么看了，谢谢哈

[rookie2luochao]

@lyang 哈哈哈，可能我们写的东西不太好，尴尬

[flyingcrp]

@rookie2luochao 抛弃在代码中通过注释的方式编写 api 文档(当然这并没有错). 而尝试设计+自动测试为开始,先设计和定义好 api,然后针对设计的 api 进行测试编写(旧的方式是写测试用例),只是这个测试是由工具点点点就完成了.
Q1: 如何保证代码与 api 的维护呢? 凡是改动代码必须跑已有的用例
Q2: 如何通知调用方结构有更新呢(人工通知)? 利用工具的 webhook 同步到 im 或任何你们协作的工具
Q3: 更新后的 API 对方怎么看到最新的呢(旧的方式是发布新的文档)? 相同工具下改动都会被同步.所以对方看到的永远是最新的.