jsonschema - 从 jsonschema 转换为 swagger 2.0

Question

关闭。这个问题不满足Stack Overflow guidelines .它目前不接受答案。












想改善这个问题吗？更新问题，使其成为 on-topic对于堆栈溢出。

10 个月前关闭。




Improve this question




swagger 新手，想知道是否有办法将现有的 jsonschema 模型转换为 swagger 规范。

Answer 1

json-schema 和 swagger/openapi 规范之间没有直接的转换。

来自 openapi 2.0 documentation :

The files describing the RESTful API in accordance with the Swagger specification are represented as JSON objects and conform to the JSON standards. YAML, being a superset of JSON, can be used as well to represent a Swagger specification file.

之后:

An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the user. In the latter case, $ref fields MUST be used in the specification to reference those parts as follows from the JSON Schema definitions.

因此，招摇使用 json-schema ，但它也增加了一堆新的部分和规则。

但是，如果您精心制作 json-schema，例如将所有对象定义在 definitions 中标签，您可以直接复制或嵌套它作为 swagger 规范的一部分。

您也可以使用 "$ref" to point to objects defined in external json-schema files ，无需任何转换。