RESTful Web APIs Quotes

“The term “statelessness” is getting at the fact that the server doesn’t care what state the client is in.”
― Leonard Richardson, RESTful Web APIs: Services for a Changing World

“thinking of API design as resource design is a very effective way to avoid thinking about hypermedia.”
― Leonard Richardson, RESTful Web APIs: Services for a Changing World

“it seems we’ve got a mental block when it comes to hypermedia in web APIs. This is a big problem, because hypermedia is the feature that makes a web API capable of handling changes gracefully.”
― Leonard Richardson, RESTful Web APIs: Services for a Changing World

“in a hypermedia-based design, resources don’t matter as much. The designer’s job is to identify all the state transitions.”
― Leonard Richardson, RESTful Web APIs: Services for a Changing World

“the “API call” metaphor inevitably exposes the server’s implementation details to the clients. This introduces coupling between server code and client code.”
― Leonard Richardson, RESTful Web APIs: Services for a Changing World

“The things you’re accustomed to are dangerous. In applications intended for use within an organization, a design based on API calls works well and is easy to develop. The API call metaphor assumes away the network boundary and lets a client invoke a method on a remote computer just like it would call the API of a local code library.”
― Leonard Richardson, RESTful Web APIs: Services for a Changing World

“URLs don’t even need to make sense to human eyes. But we humans prefer nice-looking URLs, like”
― Leonard Richardson, RESTful Web APIs: Services for a Changing World