Wishful thinking about a Tumblr API v3

Let’s say you want to read a Tumblr post information from their API v2. Nothing special at the first look, but beyond the obvious parameters, there’s an interesting one: notes_info. The API designer thought to make this optional (it defaults to false) as to not overload the server and cause unneeded traffic with all the likes and reblogs your requested post might have – especially if popular.

Continue reading

How about OpenAPI descriptions and Swagger UI in your Java REST API?

I have this Quarkus project which uses basic JAX-RS annotations to generate your API, fairly basic and trivially simple. Yes that’s all Quarkus needs and it looks pretty much like Spring MVC or anything else. Now I’d need to create Postman test data and buid tests for all these endpoints or… or integrate it with Swagger – both to add OpenAPI style documentation AND to have a nice web GUI client to read infos and test them.

Continue reading

SoCraTes day in Zurich, 2015

Last Friday I attended the “Software Craftsmanship and Testing” conference. I said “last Friday” because it lasted only one day, unlike the typical 3 days format (including night stays)… but for me it was just enough, I cannot really afford the extended versions. This event brought together about 50 folks with all possible backgrounds – developers .net, Java, JS, but also devops people… really, everything. The “unconference” format meant at the beginning whoever wanted to propose topics did so by placing a note on the schedule table, and explained in a few words what his discussion topic is. Continue reading