如题,我现在公司不同的服务器上有很多的服务,都是 restful 的。
问题是现在 restful 的服务多了之后,我记不住,每次都要翻项目文档。
我现在想找一个开源项目,把这些 URL 都列出来,然后能写出来这些 url 都是怎么访问的,就类似 swagger 。
但是这个项目是独立于我的 restful api 的,只是一个请求代理和展示。
谢谢各位 v 友了。
1
hnliuzesen 40 天前
试试 IDE 装个插件 easyYapi ,用 yapi 管理的话,主页会列出来所有的项目,点进项目里会有所有的 API 。
|
![]() |
2
somebody1 OP @hnliuzesen
感谢回复啊,但是我的 restful 是啥也没有的,我希望是单独写个配置文件,然后它列出来 |
![]() |
3
eGlhb2Jhb2Jhbw 40 天前 ![]() 手动写 Swagger 的描述不行么 🤧
|
![]() |
4
somebody1 OP @eGlhb2Jhb2Jhbw
手动写可以,但是我是多个项目,有的没有 swagger ,我想搞到一块,列出来 |
5
DeepUse 40 天前 via iPhone
vs code 插件 rest client
|
![]() |
6
lisxour 40 天前
postman collection
|
![]() |
7
eGlhb2Jhb2Jhbw 40 天前
@somebody1 #4
我还是没理解,为啥直接写描述不行,和项目有没有 swagger 有啥关系。像这个网站 https://editor.swagger.io/ ,里边描述的也不是他这个 service 的 API 啊 |
![]() |
8
Dogxi 40 天前
Apifox 可以试一下
|
![]() |
9
Dogxi 40 天前
#8 抱歉啊 没看见开源项目🤔
|
10
Ayanokouji 40 天前
redocly 了解一下,自行管理
|
![]() |
11
jiangzm 40 天前
随便找一个 api 管理工具都可以, 不要觉得 swagger 是跟 api 服务是绑定的,只是 api 服务为了方便默认集成了而已,你完全可以单独用 swagger 来管理多个 api 服务。
当然其他像 postman/hoppscotch(开源)/yapi(开源)/reqable/apifox/apipost/... 都可以。 |
12
hnliuzesen 39 天前
@somebody1 #2 如果是 Spring Boot 开发的 RESTful 服务,应该会用到 @RestController 注解,easyYapi 会自动扫描这些注解,生成文档,到这一步和你要一个聚合的配置文件还有差距,可以再用类似 fjc0k/yapi-to-typescript 这种项目把接口再抓回来。
其他语言不太熟悉,感觉应该可以类比,python RESTful 服务一些框架也是靠修饰符来配置路径,应该也会有工具能处理,可能要找一下。 可以问问 AI 有没有什么符合你需求的工具推荐 |