DEV Community

Arnaud Dagnelies
Arnaud Dagnelies

Posted on • Edited on

1

Day 15-16: Better than Swagger UI (repaired)

Let's start with the result to pike your interest. Here is a screenshot.

Image description

You can also see it in action here

Please note that this is work in progress, it will change in the coming days and weeks. This is just a peek preview.

If you do not know what this is, it is a UI for an OpenAPI specification. Somehow IMHO OpenAPI and the related Swagger is getting worse rather than better over the years, but it is still incredible and irreplaceable because of the tooling surrounding it.

One of the main tooling is of course this interactive documentation to experiment with APIs directly by sending requests and watching responses. What I find a pity though is that Swagger UI, the default UI and father of OpenAPI, does not look as good as in its early versions. However, fear not, there are plenty of alternatives. The one I favor, which is depicted in the screenshot, is RapiDoc. Try it out, it's good!

Besides of this, OpenAPI has lots of other very practical tooling. It can be used to generate client libraries in various programming languages, or to be imported in various third party tools, ranging from testing tools to integration platforms.

Image of Datadog

The Essential Toolkit for Front-end Developers

Take a user-centric approach to front-end monitoring that evolves alongside increasingly complex frameworks and single-page applications.

Get The Kit

Top comments (0)

A Workflow Copilot. Tailored to You.

Pieces.app image

Our desktop app, with its intelligent copilot, streamlines coding by generating snippets, extracting code from screenshots, and accelerating problem-solving.

Read the docs

👋 Kindness is contagious

Please leave a ❤️ or a friendly comment on this post if you found it helpful!

Okay