swagger - swagger 参数 - 标题覆盖架构中根对象的 XML 对象

Question

  parameters:
    - name: message
      in: body
      schema:
        type: object
        title: Ping_Request
        xml:
          name: message

在 swagger ui 中，这个例子是

<?xml version="1.0"?>
<Ping_Request>

对于嵌套对象，它可以正常工作（使用来自 XML 对象的标签名称，而不是来自该对象的标题）。对于结果模式根对象也可以。

仅在 body 参数中的根对象的问题。

Answer 1

这可能是您使用的 Swagger UI 版本中的一个错误。版本 3.0.5 使用正确的根标记呈现 XML 示例：

<?xml version="1.0" encoding="UTF-8"?>
<message>
</message>