API Documentation - Swagger
Heitor José Tessaro
Stoplight Elements (https://docs.stoplight.io/docs/elements/d6a8ba3f3c186-stoplight-elements) is an option to integrate API documentation into a Docusaurus project.
Sheldon Reddy
Heitor José Tessaro: Do you have any documentation on hand to show how this is done?
Heitor José Tessaro
Sheldon Reddy: I know that Codat uses it (https://github.com/codatio/codat-docs). However, I discovered this option recently, and I still need to test it.
Kennammp
Please make this happen, it's a big gap in what your otherwise excellent product can do. Redoc doesn't let you make requests to the API. Once Docusaurus can provide a functioning API portal this will open up a whole new revenue stream for you guys, as it will truly be a fully functioning developer portal as opposed to just the docs.
Jeff
Just want to add that previous commenters mentions of using Redoc are great except Redoc cannot make actual requests to your API (unless you are on some kind of paid version). This is IMO a bit useless, as it is otherwise just documentation for you to "read along with".
J
Javier Rubio
Redocusaurus really helped me to do this, you might want to check it out: https://github.com/rohit-gohri/redocusaurus
F
Fokke Dekker
Old thread but commenting for support adding native support for some API spec page would be awesome.
Mike Howes
The ability to import swaggers and provide interactive API docs would be great! We could get rid of SwaggerHub.
Sébastien Lorber
Andreas Taube
Johannes Ferner how did you manage to isolate the classic-theme stylings to not interfere with the redoc styles?
Johannes Ferner
Andreas Taube: some manual quick&dirty overrides - it wasn't too much.
Andreas Taube
Johannes Ferner: I see, thanks for the feedback, I finally created 2 sides behind an nginx to solve this for now. The only annoying thing is the react router intercepting relative paths. I solved this with the target attribute.
Johannes Ferner
We have actually integrated redoc on https://developer.fiskaly.com/api/kassensichv
Should be possible with Swagger as well (if there is a react component of it)
<RedocStandalone
specUrl='https://kassensichv.io/api/spec'
options={{
requiredPropsFirst: true,
noAutoAuth: true,
hideDownloadButton: true,
onlyRequiredInSamples: true,
nativeScrollbars: true,
scrollYOffset: 60,
theme: { colors: { primary: { main: '#2da8d3' } } },
} }
/>
We're still working on rendering it statically soon.
Until then it spawns a reDoc standalone
Johannes Ferner
We have actually integrated redoc on https://developer.fiskaly.com/api/kassensichv
Should be possible with Swagger as well (if there is a react component of it)
<RedocStandalone
specUrl='https://kassensichv.io/api/spec'
options={{
requiredPropsFirst: true,
noAutoAuth: true,
hideDownloadButton: true,
onlyRequiredInSamples: true,
nativeScrollbars: true,
scrollYOffset: 60,
theme: { colors: { primary: { main: '#2da8d3' } } },
} }
/>
We're still working on rendering it statically soon.
Until then it spawns a reDoc standalone
Edgar Silva
Johannes Ferner: Hi could you explain a bit how you did it?
Load More
→