RSS

Monthly Archives: September 2018

Web API Design Part Nine: Versioning

Episode 95

Today’s episode is sponsored by the rain in Amsterdam and werewolves. It’s my second trip here within last two weeks with the initial goal of attending AWS trainings and some sightseeing, but AWS canceled one of these a day after my company bought non-refundable plane tickets and booked the hotel, so… more emphasis on sightseeing, or rather sitting in the coffee shop waiting for better weather. Why werewolves? Well, because in this installment of our long-running series on API design, we will talk about versioning and I find the werewolf a decent allegory to represent breaking (or tearing) changes in API that leads to a dilemma: which versioning strategy should be employed. And because I like fantasy themes for my articles.

aleksandr-nikonov-the-werewolf-by-niconoff-d59dlra

Image by Aleksandr Nikonov

There are many approaches to versioning with pros and cons and it’s difficult to definitively choose one or the other. We will explore possibilities of how to version and,  where to actually put the version information, including URI, parameters, content negotiation, custom headers, or… nowhere at all. We are going to talk about breaking and non-breaking changes and various considerations and hints relevant to helping clients of your API deal with the evolution of our system in a bearable way.

Shapeshifting

Before we start to multiply API version, we should consider whether we really need it. Backward compatible, or non-breaking changes should not Read the rest of this entry »

 
Leave a comment

Posted by on September 30, 2018 in API, Technology

 

Tags: , , ,

Join JDD 2018

Episode 94

A little break from API design series, to share some news. I was again invited to be a media partner of JDD – a Java conference that will take place at Nowohuckie Centrum Kultury in Cracow, on October 8-9th. As a result, I will have for all of you not only a 15% discount code but also one entirely free invite. If you are curious about last year’s details, have a look at what was going on day one and day two.

image1

What new at JDD this year?

One of the JDD 2018 goals is consistent and rich in content program, which was prepared by CFP ideas and JDD Program Committee suggestions. The schedule includes  Spring, Serverless, Reactive Streams, GraphQL, REST API, Reactive Programming and Java, Java 8, Java 9 i Java 10, of course! “Meat and practice” – live coding, case studies – this is what you can expect from JDD this year. Furthermore Read the rest of this entry »

 
Leave a comment

Posted by on September 5, 2018 in Events, News, Technology

 

Tags: , ,