Designing the APIs for an internal set of services

Apr 25, 2014

The success of an API is measured by how fast and easy developers can integrate with that.

In the micro-services environment, where each service has a well-defined responsibility, it’s not enough to have a well-designed API, it’s necessary to establish a contract between the APIs, so the integration between them may be feasible.

In this talk, I walk through a set of best practices that will help to design APIs and define a communication service contract. Besides that, I deep into some best practices that will help to build better APIs, at the same time defining a communication service contract. I share some answers that I have found for the questions above. From developer experience(DX) to versioning, error handling, authentication and more. And, above all, how to create APIs that developers love.

Despite the fact that I was a little nervous since it was my first experience with such a large audience, I hope you enjoy it!

Cover Photo by Loai Alyamani