关于openAPI

如下文章详细介绍了openAPI的各个方面，感谢原作者

https://blog.yanick.site/2018/08/13/other/swagger/

 

1. 关于swagger API 文档里的$ref:

有时会使用 $ref 来引用其他文档或者定义，通常格式如下：

$ref: "A#B"

其中A是引用的那个文档， B是引用的位置路径，如果没有A，则就是引用当前文档里的内容，例如：

$ref: "#/paths/~1regression/post/responses/400/content/application~1json/schema"

表示引用当前文档的paths 下的/regression下的post下的responses下的400下的content下的application/json下的schema

其中因为 /  是Json pointer的保留字符，所以需要转义成~1, 类似的还有~ 转义成~0