mrin9 / RapiPdf

PDF generation from OpenAPI / Swagger Spec

Home Page:https://mrin9.github.io/RapiPdf

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Using content to define serialization is not supported in query

ocimer opened this issue · comments

A complex query parameter that uses content to define serialization is not supported. See "Parameter object" in Swagger docs.

When trying to generate PDF from YAML below it fails. There are no logs that would report the failure, which is disappointing.

openapi: 3.0.0

info:
  version: 0.1.0
  title: "My API. (Test)"
servers:
  - url: "http://example.com/my-api"
    description: "My server"

paths:
  /locations:
    get:
      summary: List of locations
      description: "Return a list of all locations the user has access to."
      operationId: listLocations
      security:
        - tokenJWT: []
      parameters:
        - $ref: "#/components/parameters/FilterParam"
      tags:
        - Locations
      responses:
        "200":
          description: "A list of locations."
        "401":
          description: "Unauthorized."

components:
  parameters:
    FilterParam:
      name: filter
      in: query
      required: false
      description: "Filter as a JSON object."
      content:
        application/json:
          schema:
            type: object
            required:
              - name
            properties:
              id:
                type: integer
              name:
                type: string

Removing content and application/json from FilterParam solves the issue.

components:
  parameters:
    FilterParam:
      name: filter
      in: query
      required: false
      description: "Filter as a JSON object."
      schema:
        type: object
        required:
          - name
        properties:
          id:
            type: integer
          name:
            type: string