Chapter 08: Naming

It’s been several years since I released the first version of my API design guide, and I’ve always felt that something was missing. Something that influences every other chapter. When I analyzed the most common issues in APIs designed by analysts and developers I had trained, one key theme gradually emerged: proper naming. Good naming fundamentally shapes the entire interface, from the URL structure, through parameters, all the way to the design of the response body.