第1行是Open API的版本
第4行 info 的 version 是指API的版本, 而info这个版本必须使用双引号括起来, 否则OAS解析器会把它当成数字, 从而导致文档验证失败(因为它的类型应该是字符串...这里面使用 {} 仅仅是为了让文档验证通过, 因为我目前还没有写什么内容. 在YAML里, {} 表示一个空的对象, 而非空的对象则不需要这对大括号....注意, 这里第1行 openapi下面的波浪线表示文档验证失败.
在OAS文档里, 一个操作必须在responses属性里提供至少一个响应:
?...此外 JSON Schema 还支持 对象属性类型:
?
JSON Schema 的东西比较多, 具体可以查找一下官方文档....JSON引用这个属性的名字是$ref, 它的值是一个URL. 这个URL可指向本文档内部甚至外部的组件. 这里我只引用文档内部的组件.
?