Forum Discussion

WT's avatar
WT
Occasional Visitor
3 years ago

Swagger xml attribute representation

Swagger lacks representing xml with attributes properly. I think the problem is OpenApi only considered key/value pair each element just like JSON. Is there any plan to fix it. Example of xml <...
Swagger Codegen
Swagger Core
Swagger Editor
Swagger UI
ponelat's avatar
ponelat
Staff
3 years ago

Hi WT 

 

XML is supported by OpenAPI, take a look at https://swagger.io/docs/specification/data-models/representing-xml/.  Here is your example written down...

 

openapi: 3.0.3
info:
  title: XML Example
  description: XML Example
  version: "0.1"

paths:
  /foo:
    post:
      requestBody:
        content:
          application/xml:
            schema:
              $ref: '#/components/schemas/Message'
      responses:
        '201':
          description: Created
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/Message'
    
components:
  schemas:
    Message: 
      type: object
      xml: 
        name: MESSAGE
      properties:
        att1:
          type: string
          example: Name
          xml:
            attribute: true
        att2:
          type: string
          example: DOB
          xml:
            attribute: true