您可以记录其他人使用 swagger 开发的 API 吗?

Can you document the APIs which are developed by someone else using swagger?

我是 swagger.io 的新手。我有一堆由不再与我合作的团队开发的 API。所以这些 API 没有被他们正确记录。所以,我正在考虑使用 swagger 并正确记录它们。

但问题是,是否可以大摇大摆地记录这些 API?

如果是,如何? 如果没有,还有其他 tool/framework 可以让我做吗?

是的,您可以在 Swagger Editor 中为 API 手动编写 OpenAPI (fka Swagger) 定义(.yaml 或 .json),然后使用 Swagger UI 显示 API 文档。但是,在这种情况下,OpenAPI 定义与 API 实现不同步(即未链接到源代码),因此如果实现发生变化,您将需要更新 OpenAPI手动定义。

不招摇,但 WireMock 会让观察和记录一个 API 作为黑盒。

http://wiremock.org/docs/record-playback/