The REST API Design Handbook

by George Reese

most APIs suck is because, as a community, we’re all still learning how to get them right. We know SOAP sucks. We know we should be RESTful, but it’s not common knowledge what it means to be RESTful or why being RESTful is important.