You asked for it to happen, and here it is! We’re happy to announce that you can now do all sorts of wonderful auto-generated things in Directual with Swagger.
Why? Because at the end of the day, all that truly matters is reducing the amount of pain it takes to achieve your goals, and Swagger will be instrumental in doing just that.
Swagger is an OpenAPI tool that helps to generate libraries in a variety of languages, create documentation, perform testing (all automatically), and structure API data. It’s done via a YAML or JSON requests to your API. It’s extremely versatile, and it has SWAG in its name. What’s not to like?
Let’s expand on what it does a little.
API creation
Code-first API development (and vice versa)! Generate APIs based on the code itself and automatically supplement descriptions straight into the source code.
Interactive APIs
You can generate client libraries in more than 40 languages and formats, pretty much no-coding the API side of your project, and with API calls you can make directly in your browser. And of course, you can connect it with a variety of other tools to make it even more useful—like for automated testing, for instance.
Documentation
Swagger has its own HTML-based UI that connects directly to live APIs to make requests and submit data. What’s more, Swagger can read the API structure and annotations to automatically generate documentation.
How to use Swagger with Directual
No need to enable or connect anything, everything is already integrated. It’s all pretty simple. Swagger specification can be composed for any and all API endpoints you wish to use.
Try it out by enabling Swagger documentation in the API endpoint configuration of your particular project:
Below the setting, you can find a link to the endpoint itself. Copy and paste it to your browser to test it out.
Afterword
Swagger, like Directual, aims to reduce the time spent writing code stuff manually, or better yet, get rid of it altogether. Use both to get the most of a strong back-end, front-end, and proper API to hook it all up together.
In case of questions, do let us know by sending a message to hello@directual.com. Always happy to hear from you!