REST API Design Rulebook: Designing Consistent RESTful Web Service Interfaces

"O'Reilly Media, Inc.", 18 . 2011 . - : 116

In todays market, where rival web services compete for attention, a well-designed REST API is a must-have feature. This concise book presents a set of API design rules, drawn primarily from best practices that stick close to the Webs REST architectural style. Along with rules for URI design and HTTP use, youll learn guidelines for media types and representational forms.

REST APIs are ubiquitous, but few of them follow a consistent design methodology. Using these simple rules, you will design web service APIs that adhere to recognized web standards. To assist you, author Mark Massé introduces the Web Resource Modeling Language (WRML), a conceptual framework he created for the design and implementation of REST APIs.

  • Learn design rules for addressing resources with URIs
  • Apply design principles to HTTPs request methods and response status codes
  • Work with guidelines for conveying metadata through HTTP headers and media types
  • Get design tips to address the needs of client programs, including the special needs of browser-based JavaScript clients
  • Understand why REST APIs should be designed and configured, not coded



Chapter2Identifier Design with URIs
Chapter3Interaction Design with HTTP
Chapter4Metadata Design
Chapter5Representation Design
Chapter6Client Concerns
Chapter7Final Thoughts
Appendix My First REST API



Mark Masse resides in Seattle, where he is a Senior Director of Engineering at ESPN.

Mark has fourteen years of engineering, management, and architecture experience with The Walt Disney Company. He began his career with Starwave creating rich, interactive Java applets for ESPN Sportszone,, and NASCAR Online. Mark architected and developed the content management system (CMS) that powers all of the Disney web sites including, and In 2008, he received a "Disney Inventor Award" for creating a "System and Method for Determining the Data Model Used to Create a Web Page."