This paper provides an in-depth evaluation of the most important features web service APIs should offer and explains why those features are important. It also examines the evolution of APIs and recommends best practices for a flexible, reliable and easily managed API set.