我目前正在为我的 API 项目使用 OpenAPI 生成器,但遇到了意外问题。当我在 OpenAPI 规范中定义默认响应时,OpenAPI 生成器似乎会自动为该默认响应分配 200 状态代码,这不是我期望的行为。
在我的 YAML 规范中,我定义了默认响应,但未指定状态代码,重点是提供意外错误的描述:
yaml 复制代码 回应: 默认: 描述:意外错误
但是,尽管未指定状态代码,生成的 Swagger 文档仍显示此默认响应的 200 状态代码,这对于错误响应来说并不准确。
还有其他人在使用 OpenAPI Generator 时遇到过这个问题吗?有没有办法阻止生成器自动将 200 状态代码分配给默认响应?任何见解、解决方法或建议将不胜感激。
提前感谢您的帮助!
我已经查看了其他响应定义,验证了 OpenAPI 规范,并检查了 OpenAPI 生成器的配置设置,但我仍然遇到此行为。
虽然 openapi-generators 是开源的并提供多种语言,这很好,但在我看来,代码生成器未按预期运行的挫败感是很常见的。
我正在构建 Fern 来改善开始使用 OpenAPI 和获取 SDK + API 文档的体验。如果您想尝试一下,您可以在几分钟内免费生成 SDK。