我想在我的 api 文档中用 2 位小数表示小数点,用 1 位小数表示。我正在使用 swagger 2.0,规范中是否有内置定义的类型或任何其他“圆形”参数,或者我唯一的选择是使用“x-”扩展?
OpenAPI (fka Swagger) 规范使用以下子集JSON 模式 https://spacetelescope.github.io/understanding-json-schema/来描述数据类型。
如果参数作为数字传递,您可以尝试使用multipleOf
如建议的本次问答 https://stackoverflow.com/q/27260587/113116:
type: number
multipleOf: 0.1 # up to 1 decimal place, e.g. 4.2
# multipleOf: 0.01 # up to 2 decimal places, e.g. 4.25
然而,multipleOf
针对浮点数的验证可能不可靠,因为浮点数学细节 https://stackoverflow.com/q/588004/113116.
如果您的号码作为字符串传递,您可以指定正则表达式pattern
对于所需的数字格式:
type: string
pattern: your_regex
在任何情况下,您也可以口头记录任何限制description
.
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)