如何在OpenAPI（Swagger）中指定默认的XML元素文本？

我正在为以下XML负载构建OpenAPI（Swagger）2.0定义，以便在Swagger UI中使用：

在此处输入值

我在计算如何显示元素

键

的默认值“在此处输入值”时遇到问题。在OpenAPI定义中，这个默认值放在哪里？我的定义如下：

“定义”：{
“addressElement”：{
“类型”：“对象”，
“标题”：“地址元素”，
“财产”：{
“关键”：{
“类型”：“对象”，
“财产”：{
“类型”：{
“类型”：“字符串”，
“示例”：“记录ID”，
“xml”：{
“属性”：true
}
},
“项目”：{
“类型”：“整数”，
“格式”：“int64”，
“示例”：“3”，
“xml”：{
“属性”：true
}
}
}
},
},
“xml”：{
“名称”：“addressElement”
}
}
}

这目前是不可能的，因为OpenAPI无法用诸如

在此处输入值

只能为对象定义属性

一些文本

但不适用于简单的

文本
元素

关于这个限制，这里有一个公开的问题：


也就是说，OpenAPI规范维护人员正在考虑使用一个选项（如XSD模式），因此您的用例可能会在OpenAPI的未来版本中得到支持。
可能的副本