Over a million developers have joined DZone.

Saving and Versioning API Definitions in Editor Using GitHub Gists

DZone 's Guide to

Saving and Versioning API Definitions in Editor Using GitHub Gists

In this article, Kin Lane discusses his friend's new take on a Swagger editor that resembles his dream API sketchbook and portfolio.

· Integration Zone ·
Free Resource

My friend Jordan Walsh just released a new take on the Swagger editor that inches closer to my vision of a dream API sketchbook and portfolio. His swagger-gist.io tool allows you to open and save your API definitions to GitHub Gists, allowing you to use the snippet sharing solution to manage your API definitions, and their evolution.

While it isn't my entire vision for an API sketchbook and portfolio, swagger-gist.io's usage of GitHub Gists is a move in the right direction. This is just the first draft of his tool, and it looks like he plans on building in more of the API definition management features I am looking for, leveraging Github Gists as the book in my sketchbook definition. (#Creative!)

I like this model, especially when it comes to collaboration and storytelling around the API design process. I could see offering more sharing features for API definitions within the editor, enabling you to email, Slack, and share throughout an API's life cycle. I can also see more copy and paste opportunities, embedding API definitions using GitHub Gists in blog, knowledge base, and forum posts, grabbing the embed code from within the editor.

I'm curious to see where Jordan takes it. I have lots of ideas, but will just keep an eye on his work. My only critique at the moment is to not couple the functionality too tightly with the word "Swagger," as that is a trademarked product. I recommend relying on "OpenAPI Spec" or, even better, some other way of identifying Gists that contain an OpenAPI Spec definition. 

Cool stuff, Jordan. Keep up the good work.

apis ,api definitions ,github ,integration

Published at DZone with permission of

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}