Machine-readable API specification formats like OpenAPI are not just for creating documentation but can be a driver for the whole API lifecycle. If you generate them from code you’re leaving half of what OpenAPI can do on the table, so it’s better to develop a specification-first API workflow.
I wrote about this topic as a guest post for Stoplight who offer cloud-based tools around OpenAPI and API design. You can read it in the Stoplight API Corner on Medium.
Disclosure: This work was paid for by Stoplight.
I’m back home in Germany after my two-week workation in Gran Canaria. These two weeks were a great experience but also way too short; as I had a lot of work to do I couldn’t explore as much of the city or the island as I wanted to. So, sooner or later, I have to go there again!
I saw the documentary Banking on Bitcoin last night. The main reason I watched it was that they hosted a screening at this very nice co-working/co-living place called The Roof here in Las Palmas. Regarding the movie itself, it’s obviously outdated since it’s from 2016 and a lot has happened in the cryptocurrency space since then.
What I liked about it: it does a good job demonstrating the beginnings of Bitcoin from the cypherpunk movement, the first startups in the space and their regulation issues as well as the search for the identity of Satoshi Nakamoto. From that perspective, I can highly recommend it.
What I didn’t like about it: the movie contains practically no criticism. Issues like scalability are glossed over, and others like the inefficient use of energy are not mentioned at all. You end up thinking that Bitcoin is without a doubt this great technology that just has to go through growing pains.
I arrived in Las Palmas de Gran Canaria today! For the next two weeks I will be working from the lovely ReStation co-working space and enjoy my free time exploring the city and the beach.
I’ve written and published an article, in which I describe how to create API test cases in Postman and then run them both within Postman as well as its command line companion Newman and finally export the collection from Postman and import it to BlazeMeter for cloud-based functional API testing.
Disclosure: This work was paid for by BlazeMeter.
As promised, I wrote an article about my experience at API the Docs Paris 2018. It’s published on the CloudObjects blog. Looking forward to your feedback!
I’m on a train on my way back home from Paris, where I had three great days! I arrived on Monday and spent the afternoon exploring the city a bit, then met some of the conference attendees for dinner. On Tuesday there was the actual API the Docs conference day at the beautiful Mozilla office. There were interesting speakers and more nice and interesting people to talk to. I’ve started writing a blog post about the event and the talks which I’ll publish on the CloudObjects Blog soon. This morning before leaving I went to see STATION F, the world’s largest startup campus, located in Paris.
I’m happy to announce that not only will I be attending API the Docs in Paris on April 24th, but my talk proposal “To SDK or not to SDK?” has been accepted by the conference committee. Currently I’m working on the talk and look very much forward to giving it in Paris soon.