使用 x-example 控制 Developer Portal 中显示的示例

在此示例中，不能使用 example（因为 OpenAPI 规范不支持 example），但可以使用 x-example。

 - name: city
   in: query
   required: false
   type: string
   maxLength: 50
   description: "Location"
   x-example: "New York"

在规范设置和允许的范围内支持 example 属性。如果未找到 example，那么在规范设置和允许的范围内支持 default。如果已找到 x-example 属性，那么将支持该属性；如果未找到该属性，那么将生成与模式匹配的随机示例。

如果规范允许您使用 example，那么应该使用 example（它优先于 x-example）。