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
Is your feature request related to a problem? Please describe.
api-distrochooser is already written in swagger, but there is no custom link about the api documentation in swagger. I can't find the link about the technical documentation about the api. For example, something like: https://docs.distrochooser.de/api-version/1/stats/
Describe the solution you'd like
I wish there was online documentation on swagger for the distrochooser api. For example, something like: https://docs.distrochooser.de/api-version/1/stats/
Describe alternatives you've considered
We can have a custom link like: https://petstore.swagger.io/
Is there any public api so that I can consult other information through an http call through the rest architecture? Something like repository: public-apis/public-apis has? Example:
Query with the get method all the statistics of distrochooser stats: https://api.distrochooser.de/api-version/1/stats/getAll
Query with the get method all the distros of distrochooser: https://api.distrochooser.de/api-version/1/distros/getAll
or https://docs.distrochooser.de/api-version/1/ ?
Additional context
"Swagger allows you to describe the structure of your APIs so that machines can read them. The ability of APIs to describe their own structure is the root of all awesomeness in Swagger. Why is it so great?"
"Well, by reading your API’s structure, we can automatically build beautiful and interactive API documentation."
"We can also automatically generate client libraries for your API in many languages and explore other possibilities like automated testing."
"Swagger does this by asking your API to return a YAML or JSON that contains a detailed description of your entire API."
The text was updated successfully, but these errors were encountered:
ghost
changed the title
distrochooser with docs to api
add link to distrochooser API documentation
Mar 5, 2023
Is your feature request related to a problem? Please describe.
api-distrochooser is already written in swagger, but there is no custom link about the api documentation in swagger. I can't find the link about the technical documentation about the api. For example, something like:
https://docs.distrochooser.de/api-version/1/stats/
Describe the solution you'd like
I wish there was online documentation on swagger for the distrochooser api. For example, something like:
https://docs.distrochooser.de/api-version/1/stats/
Describe alternatives you've considered
https://petstore.swagger.io/
https://api.distrochooser.de/api-version/1/stats/getAll
https://api.distrochooser.de/api-version/1/distros/getAll
or
https://docs.distrochooser.de/api-version/1/
?Additional context
The text was updated successfully, but these errors were encountered: