不能有多个具有相同操作 Id: clearCache

Question

我已经从swagger-UI导入了一个API，并且能够创建一个API和产品，但是当我尝试发布时，我收到此错误。 不能具有同一操作的多个操作Id：clearCache不能有多个具有相同操作 Id：getConfigurationJSON任何帮助将不胜感激。

Answer 1

如错误消息中所述，每个操作 Id 在所有操作中必须是唯一的。这在以下 Swagger-API 问题和规范中进一步解释：

https://github.com/swagger-api/swagger-editor/issues/1146

https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#fixed-fields-5

operationId：用于标识操作的唯一字符串。ID 必须 在 API 中描述的所有操作中是唯一的。工具和 库可以使用 operationId 来唯一标识操作， 因此，建议遵循常见的编程命名 约定。

Answer 2

如果仅添加 --skip 验证标志之一 getByID 将生成操作 https://github.com/swagger-api/swagger-editor/issues/1146#issuecomment-270006562