REST API Design Rulebook: Designing Consistent RESTful Web Service Interfaces"O'Reilly Media, Inc.", 18 oct. 2011 - 116 pages In todayâ??s 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 Webâ??s REST architectural style. Along with rules for URI design and HTTP use, youâ??ll 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.
|
Table des matières
Chapter 1 Introduction | 1 |
Chapter 2 Identifier Design with URIs | 11 |
Chapter 3 Interaction Design with HTTP | 23 |
Chapter 4 Metadata Design | 35 |
Chapter 5 Representation Design | 47 |
Chapter 6 Client Concerns | 71 |
Chapter 7 Final Thoughts | 85 |
Appendix My First REST API | 93 |
Autres éditions - Tout afficher
Expressions et termes fréquents
200 OK Content-Type Application Programming Interface application/json application/wrml backend Berners-Lee Boolean browser Cache-Control caching client developers client’s request consistent form constraint controller resource DELETE Docroot error response ETag example fields and links format="http://api.formats.wrml.org/application/json formatted with JSON header value href http://api.relations.wrml.org/common/self HTTP’s Hypermedia HyperText Transfer Protocol IANA indicate interaction jQuery JSONP line breaks link formulas link relation link’s media type negotiation Media Type Schema message’s metadata network-based intermediaries OAuth optional path segment POST query component query parameter Recap representational form Representational State Transfer request message request method resource archetypes resource representation resource’s response body response headers Response HTTP/1.1 response status codes response’s REST API design REST API’s resource retrieve Roy Fielding sake of visual specific standard stored resource structure syntax Tim Berners-Lee uniform interface Uniform Resource Identifier update URI path URI template URI’s web server web services World Wide Web WRML media type XMLHttpRequest