RESTful web APIs

Contiene índice

Chapter 1 Surfing the Web -- Episode 1: The Billboard -- Episode 2: The Home Page -- Episode 3: The Link -- Episode 4: The Form and the Redirect -- Application State -- Resource State -- Connectedness -- The Web Is Something Special -- Web APIs Lag Behind the Web -- The Semantic Challenge -- Chapter 2 A Simple API -- HTTP GET: Your Safe Bet -- How to Read an HTTP Response -- JSON -- Collection+JSON -- Writing to an API -- HTTP POST: How Resources Are Born -- Liberated by Constraints -- Application Semantics Create the Semantic Gap -- Chapter 3 Resources and Representations -- A Resource Can Be Anything -- A Representation Describes Resource State -- Representations Are Transferred Back and Forth -- Resources with Many Representations -- The Protocol Semantics of HTTP -- Which Methods Should You Use? -- Chapter 4 Hypermedia -- HTML as a Hypermedia Format -- URI Templates -- URI Versus URL -- The Link Header -- What Hypermedia Is For -- Beware of Fake Hypermedia! -- The Semantic Challenge: How Are We Doing? -- Chapter 5 Domain-Specific Designs -- Maze+XML: A Domain-Specific Design -- How Maze+XML Works -- The Collection of Mazes -- Is Maze+XML an API? -- Client #1: The Game -- A Maze+XML Server -- Client #2: The Mapmaker -- Client #3: The Boaster -- Clients Do the Job They Want to Do -- Extending a Standard -- The Mapmaker’s Flaw -- Maze as Metaphor -- Meeting the Semantic Challenge -- Where Are the Domain-Specific Designs? -- If You Can’t Find a Domain-Specific Design, Don’t Make One -- Kinds of API Clients -- Chapter 6 The Collection Pattern -- What’s a Collection? -- Collection+JSON -- How a (Generic) Collection Works -- The Atom Publishing Protocol (AtomPub) -- The Semantic Challenge: How Are We Doing? -- Chapter 7 Pure-Hypermedia Designs -- Why HTML? -- HTML’s Capabilities -- Microformats -- The hMaze Microformat -- Microdata -- Changing Resource State -- The Alternative to Hypermedia Is Media -- HTML’s Limits -- The Hypertext Application Language -- Siren -- The Semantic Challenge: How Are We Doing? -- Chapter 8 Profile -- How Does A Client Find the Documentation? -- What’s a Profile? -- Linking to a Profile -- Profiles Describe Protocol Semantics -- Profiles Describe Application Semantics -- XMDP: The First Machine-Readable Profile Format -- ALPS -- JSON-LD -- Embedded Documentation -- In Summary -- Chapter 9 The Design Procedure -- Two-Step Design Procedure -- Seven-Step Design Procedure -- Example: You Type It, We Post It -- Some Design Advice -- Adding Hypermedia to an Existing API -- Alice’s Second Adventure -- Chapter 10 The Hypermedia Zoo -- Domain-Specific Formats -- Collection Pattern Formats -- Pure Hypermedia Formats -- GeoJSON: A Troubled Type -- The Semantic Zoo -- Chapter 11 HTTP for APIs -- The New HTTP/1.1 Specification -- Response Codes -- Headers -- Choosing Between Representations -- HTTP Performance -- Avoiding the Lost Update Problem -- Authentication -- Extensions to HTTP -- HTTP 2.0 -- Chapter 12 Resource Description and Linked Data -- RDF -- When to Use the Description Strategy -- Resource Types -- RDF Schema -- The Linked Data Movement -- JSON-LD -- Hydra -- The XRD Family -- The Ontology Zoo -- Conclusion: The Description Strategy Lives! -- Chapter 13 CoAP: REST for Embedded Systems -- A CoAP Request -- A CoAP Response -- Kinds of Messages -- Delayed Response -- Multicast Messages -- The CoRE Link Format -- Conclusion: REST Without HTTP