The premise is simple: choose Import, and supply an OpenAPI specification. At Nexmo, we hold ours on GitHub so I just click the “Raw” button and paste the URL as a link to import, e.g.
You get a collection with all the described endpoints and when you select one, the request is already crafted such that all you need to do is fill in the values you want to send (Pro tip for Nexmo APIs: you’ll usually need to add the
api_secret field yourself).
What I love about this is how quickly I can start to poke around in unfamiliar APIs, with very easy access to request formats, descriptions of what should be in each field, and so on. The world of OpenAPI is wide and growing all the time, and as more and more API providers offer API descriptions, more and more developers will have the ability to play in the sand using familiar tools and a new API.