如何将 OpenApi3 api 定义本地化为多种语言?

Fra*_*k59 7 swagger-ui openapi

我将 API 定义为 OpenAPI3 文档,并使用 swagger UI 作为查看器。所有“描述”字段现在均为英语。但我需要支持多种语言的 API 文档(例如英语和俄语)。

如何将 OpenAPI3 文档本地化为多种语言?是否存在一些标准机制,或者唯一可能的方法是为这个问题编写我自己的自定义解决方案?

use*_*062 0

我相信这个扩展可能是一个解决方案(未经测试):https ://www.npmjs.com/package/swagger-i18n-extension

据我了解,这需要使用 JS 额外重新翻译 YAML 文件,因此我不确定它是否可以与 Swagger UI 无缝配合。