RailsConf 2014 - Designing the APIs for an internal set of services

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.