Lot of good articles were written about good design of API for external clients, but I will focus on two things which I learned: api versioning for Single Page Application array of objects in a response