有没有办法检测招摇何时发生变化？

Question

我的同事在两个月没有上交任何东西后，被安排到我手下。

今天，他们更改了一些 API 调用，使我运行了几个月的某些东西停止工作。他们更改了一些字段的名称及其工作方式。

我如何才能检测到他们将来何时这样做。

Swagger.io 就是我所说的 swagger。

Answer 1

我知道这个问题已经很老了，但是为了这些天来这里寻找答案的人们：现在有一个解决方案，称为 Swagger Diff。它可以比较两个swagger.json文件，并突出显示任何更改。

• Ruby 版本： https: //github.com/civisanalytics/swagger-diff
• Java版本： https: //github.com/Sayi/swagger-diff

您甚至可以在构建过程中使用 Ruby 版本，如果存在任何不兼容性，则构建会失败。Java 版本目前仅显示更改列表。

Answer 2

目前，还没有工具可以提供 swagger 文档之间的差异，尽管已经有人请求使用这样的工具。创建这样的工具并不一定很容易，因为例如，如果操作路径发生变化，则新旧之间没有真正的链接方式。

然而，Swagger 并不能取代正确的 API 版本管理。就像任何软件一样，API 也需要受到控制。您拥有apiVersion应该用于指示此类更改的属性。