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
Describe the problem to be solved
Automatic discovery of API documentation portals is not easy, even with great documentation websites, automatically downloading the up-to-date schemas is not an easy task.
Either a /.well-known/apis.json or /.well-known/redoc.json would be enough, to get a simple list of documented APIs on the portal you're browsing, and get the list of specification files there too, to simply download the specifications.
Otherwise another URL path would be ok, a simple exampleportal.com/redoc.json would be nice
Describe alternatives you've considered
None
The text was updated successfully, but these errors were encountered:
Describe the problem to be solved
Automatic discovery of API documentation portals is not easy, even with great documentation websites, automatically downloading the up-to-date schemas is not an easy task.
Describe the solution you'd like
My first idea is to use https://en.wikipedia.org/wiki/Well-known_URI
Either a
/.well-known/apis.json
or/.well-known/redoc.json
would be enough, to get a simple list of documented APIs on the portal you're browsing, and get the list of specification files there too, to simply download the specifications.Otherwise another URL path would be ok, a simple
exampleportal.com/redoc.json
would be niceDescribe alternatives you've considered
None
The text was updated successfully, but these errors were encountered: