You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I am currently rewriting the docs of my self-hostable app, which means that the API url that is used differs from user to user. It would be pretty cool if the server url could be customizable by the end user, and it is actually part of the openapi spec: https://swagger.io/docs/specification/v3_0/api-host-and-base-path/#
Describe the solution you'd like
Show an input when the server url is set to variable, so the user needs to set their own URL to be able to test the endpoints.
Describe alternatives you've considered
Not having a server URL but that would be a shame, as the interactive playground would be awesome.
Additional context
Definition:
servers:
- url: '{protocol}://{fqdn}/api'
description: 'The API is running at `/api` of your AirTrail instance.'
variables:
protocol:
enum:
- 'http'
- 'https'
default: 'https'
fqdn:
default: 'airtrail.example.com'
Swagger Editor example:
(I don't necessarily need the variables, one input with the whole base url would be awesome as well)
The text was updated successfully, but these errors were encountered:
What problem will this feature address?
I am currently rewriting the docs of my self-hostable app, which means that the API url that is used differs from user to user. It would be pretty cool if the server url could be customizable by the end user, and it is actually part of the openapi spec: https://swagger.io/docs/specification/v3_0/api-host-and-base-path/#
Describe the solution you'd like
Show an input when the server url is set to variable, so the user needs to set their own URL to be able to test the endpoints.
Describe alternatives you've considered
Not having a server URL but that would be a shame, as the interactive playground would be awesome.
Additional context
Definition:
Swagger Editor example:
(I don't necessarily need the variables, one input with the whole base url would be awesome as well)
The text was updated successfully, but these errors were encountered: