如何在Swagger Open API 3.0中定义常量字符串

Question

swagger open api 3.0中如何定义常量字符串变量？如果我定义枚举，它将如下所示

"StatusCode": {
        "title": "StatusCode",
        "enum": [
          "success",
          "fail"
        ],
        "type": "string"          

 } 

但是枚举可以是值列表，有什么办法可以在swagger open api 3.0中定义字符串常量

可以从http://editor.swagger.io/执行代码

Answer 1

正如@Helen 已经指出的那样，正如您可以在链接的答案中阅读的那样，目前它似乎没有比enum只有一个值的an 更好。可以粘贴到http://editor.swagger.io/ 的完整示例：

{
  "openapi": "3.0.0",
  "info": {
    "title": "Some API",
    "version": "Some version"
  },
  "paths": {},
  "components": {
    "schemas": {
      "StatusCode": {
        "title": "StatusCode",
        "enum": [
          "The only possible value"
        ],
        "type": "string"
      }
    }
  }
}

Github 上有一个相关主题，目前尚未解决：https : //github.com/OAI/OpenAPI-Specification/issues/1313