Swagger 以昂首阔步的姿态表示静态响应

Swagger 以昂首阔步的姿态表示静态响应,swagger,swagger-2.0,Swagger,Swagger 2.0,对于某些操作,我们的API使用JSON的静态位进行响应,例如: {"status":"ok"} 我最接近于对此进行模型定义的是: definitions: OKMessage: type: object properties: status: type: string enum: ['ok'] 但感觉应该有一种更直接的方式来表示模型中的静态字符串(并产生更清晰的文档)。规范中有我遗漏的东西吗?我认为这是定义响应的正确方法。您可以

对于某些操作,我们的API使用JSON的静态位进行响应,例如:

{"status":"ok"}
我最接近于对此进行模型定义的是:

definitions:
  OKMessage:
    type: object
    properties:
      status:
        type: string
        enum: ['ok']

但感觉应该有一种更直接的方式来表示模型中的静态字符串(并产生更清晰的文档)。规范中有我遗漏的东西吗?

我认为这是定义响应的正确方法。您可以考虑使用String(不枚举)来为将来添加不同的值(例如错误、处理等)提供灵活性。