parameters:
- in: path
name: userId
schema:
$ref: './components/schemas.yaml#/userId'
required: true
description: Unique numeric ID of the user to get
example: userid12
get:
tags:
- User Management
...
Swagger-UI configuration options:
No options are used, just the plain container is started with
docker run -p 80:8080 -e SWAGGER_JSON=/tmp/swagger.yaml -v $(pwd):/tmp swaggerapi/swagger-ui
Describe the bug you're encountering
If a path object is referenced the common parameters of the path are not displayed in the swagger-ui.
To reproduce...
Steps to reproduce the behavior:
create a main file.
Reference a path object (see above), which has common parameters for the path
See the error in the swagger-ui. The parameter is not shown...
Expected behavior
The parameter is shown.
Screenshots
Additional context or thoughts
I also tested this with redoc. He shows the parameter correctly.
Also if I resolve all references in the main file via a cli tool (speccy) and create one file the parameters are shown correctly again.
Q&A
Content & configuration
Example Swagger/OpenAPI definition: Main File:
included File via ref
Swagger-UI configuration options: No options are used, just the plain container is started with
Describe the bug you're encountering
If a path object is referenced the common parameters of the path are not displayed in the swagger-ui.
To reproduce...
Steps to reproduce the behavior:
Expected behavior
The parameter is shown.
Screenshots
Additional context or thoughts