Swagger 招摇过市:是否可以将操作参数设置为常量/只读?

Swagger 招摇过市:是否可以将操作参数设置为常量/只读?,swagger,Swagger,这是我对某个参数的描述: { “名称”:“myParam”, “说明”:“我的参数说明”, “必需”:正确, “参数类型”:“查询”, “类型”:“字符串”, “defaultValue”:“myValue” } defaultValue是参数可以拥有的唯一值,因此是否有方法声明它?在swagger ui的上下文中,我需要参数的文本框是只读的。我用的是招摇过市1.2 谢谢正确的声明方式是: { "name": "myParam", "description": "My para

这是我对某个参数的描述:

{
“名称”:“myParam”,
“说明”:“我的参数说明”,
“必需”:正确,
“参数类型”:“查询”,
“类型”:“字符串”,
“defaultValue”:“myValue”
}
defaultValue是参数可以拥有的唯一值,因此是否有方法声明它?在swagger ui的上下文中,我需要参数的文本框是只读的。我用的是招摇过市1.2


谢谢

正确的声明方式是:

{
    "name": "myParam",
    "description": "My param description",
    "required": true,
    "paramType": "query",
    "type": "string",
    "enum": [ "myValue" ]
}

“enum”属性设置可能的值。为其设置单个值后,这是唯一可以使用的值,用户可以在UI中进行选择。

为什么要定义不能更改的参数?感谢您的回复!当类型为string时,这非常有效,但是,在其他情况下会发生什么,例如bool?我想我可以将它声明为一个值为“true”或“false”的字符串,但如果我从中生成一个客户端库,它看起来就不那么优雅了。有什么想法吗?这取决于您使用的招摇过市规范版本。在1.2及之前版本中,“enum”仅适用于字符串值。在2.0中,“枚举”可用于所有原语,因此您可以将其用于布尔值、数字等。